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Section 1: General Client Information 



1 • Which n« !?stjpn.s are appropriate for the Client Technical Discussion Group? 

2. Wh a t is Netsca pe client softwa re ? 

3. What is Netscape Netcaster (a/k/a Constellation )? 

4. Does Nayjgatgr sup^rt. styje sheets? 

5. Does Navigator support the <OBJECJ> tag? 

6. Which image formats does Navigator support? 

7. What are cookies, and how do I use them to maintain state? 

8. What is the Open Profiling Stand 

9* Which protocols does .Navigator recognize? 

10. Does Netscape client software support IMAP? 

1 1 . Does Netscape client software support LD AP? 

1 2. Does Netscape client software, support HOP? 

1 3. How can I upload files via FTP using Navigator? 

14. What is the Netscap e Every where - Unlimited_Distnbu^ 

15. VVhat did Netscape announce about Netscape Communicator 5.0 source code? 

16. How does Netscape client software support vCard? 

17. Which platforms are supported in Netscape Communicator? 

1 8 . What is Navigato r's "cache" and howjihould I manage it? 

19. How can I keep others from using my personal certificates jn Navigator? 

20. What software is available to digitally sign scripts and applets? 

2 1 . I've tried using L a yers in Communicator, but wh at about style-sh eet layout? 
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22. How can I support multiple users on one copy of Communicator? 

23. What is canvas mode? 

24. How can multiple employees share a commonly accessible address book? 

25. How can I suppressihejptedline that appears around selected [inked images? 

26. Location independence: what js it and how is Netscape client software supporting it? 

27. How can I force a web page not to be cached on the Client? 

28. What is Smart Update? 

29. Sometimes I get "Data Mi ss ing" error, Why? 

30. Can I use Navigator^ .ActiveX control? 

31. How do I remove the sinaie-pixel border from frames? 

32 . Can I launc h Netscape Composer from H TML or JavaScri pt? 



1.1: Which questions are appropriate for the Client Technical Discussion Group? 

The Client Technical discussion group is the proper place for discussion of Netscape client software such as 
Netscape Navigator and Netscape Communicator. In general, questions asked in our discussion group pertain to 
"big picture" issues such as future capabilities of client software and the ability to extend Netscape Communicator 
components such as Composer and Navigator. Although our group is not as heavily used as some of the more 
popular DevEdge discussion groups, it is a valuable resource for many questions which don't seem to fit 
elsewhere. For Netscape Netcaster issues, please use the TOtsca^xlient.netcaster.beta discussion group For 
issues pertaining to JavaScript, please use the netscape.devs-iavascript discussion group. Plug-in developers 
with specific questions about plug-ins should use the netscape.devs-pluoins discussion group. 



1.2: What is Netscape client software? 

Netscape client software includes Cpmmunicatpr as its flagship, which is available in both Professional and 
Standard editions. Additionally, Netscape client software includes Navigator plug-ins such as LiveAudio 
LiveVideo, and others. 



1.3: What is Netscape Netcaster (a/k/a Constellation)? 

Netscape Netcaster is the powerful "push" component of Netscape_Cpmmunicator that lets you customize, focus 
and automatically receive the information you care about. Built entirely as a crossware application, Netcaster was 
delivered to market nearly 6 months ahead of schedule. Netcaster enables delivery of two types of channels - 
Web server channels based on Dynamic HTML, and Marimba Castanet-based channels. Netcaster was first 
announced under the code name "Constellation." 



1.4: Does Navigator support style sheets? 

Netscape Navigator 4.0 and up, a component of Communicator, supports CSS-1 (for control of styles), CSS-P (for 
absolute positioning), and the W3C Document Object Model (for animation and drag and drop) via JavaScript. 



1.5: Does Navigator support the <OB ject> tag? 

Navigator 4.0, a component of Communicator, supports the <OBJECT>tag as defined in the current W3C working 
draft . The tag allows insertion of objects such as (but not limited to) images, signed JavaScript JAR files, Java 
applets, and multimedia files. For information about using the <OBJECT> tag with plug-ins, see the Plug-in Guide. 



1.6: Which image formats does Navigator support? 

Currently, Navigator supports gif87 and gif89a formats, as well as JPEG and progressive JPEG. Animations and 
interlacing are made possible through support of the qif89a specification . Navigator 4.04 and up now support 
natively the new PNG format, although lacking of alpha channel support. A reference specification for PNG is 
available. 



1.7: What are cookies, and how do I use them to maintain state? 

Cookies are a general mechanism that can both store and retrieve information on the client side of the 
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connect on The addition of a simple, persistent, client-side state significantly extends the capabilities of Web- 
based client-server applications. Netscape has made a cookjespec available online. Additionally Dannv 
Goodman has written a View Source article which describes how to set and retrieve cookies through JavaScript 



1.8: What is the Open Profiling Standard (OPS)? 

When Netscape created cookie technology, it provided an immediate answer to the needs of maintainina state 
across sessions in client-server communication. However, cookies have also been used to track data such as 
name, email addresses or interests, based on what users tell specific Web sites. In efforts to both extend 
capacities to support that functionality as well as satisfy the concerns of privacy advocates Netscape Verisian 
and Firefly have proposed the Open Profiling Standard (OPS). Originally announced in May with support from 
over 60 independent companies and organizations, OPS will provide Internet site "developers with a uniform 
architecture for leveraging Personal Profile information to offer individuals tailored content goods and services 
that match their personal preferences while protecting their privacy. OPS has been submitted to the W3C for 
consideration as a standard. 



1.9: Which protocols does Navigator recognize? 

The following list summarizes known protocols which Netscape client software either currently uses once used 
or will someday use: ' 

http:// (Hypertext Transfer Protocol) 
https:// (Hypertext Transfer Protocol via SSL) 
ftp:// (File Transfer Protocol) 
news:// (NNTP Protocol) 
snews:// (For NNTP postings via SSL) 
news: (For using the default news server) 
Idap:// (Lightweight Directory Access Protocol) 
gopher:// (The old Gopher hypertext stuff) 
telnet:// (Launches a telnet helper application, if installed) 
javascript: (Executes javascript statements) 
mocha: (Executes javascript statements) 
pop3:// (Post Office Protocol) 

addbook: (To add vCard entries to Communicator's Address Book) 

about: (Internal URLs, Easter Eggs, employee home pages and other various pages and images) 
castanet: (Castanet Tuner URLs for Netcaster) 
file:// (Local file system access) 
mailbox: (Mail folder access) 
imap:// (Internet Message Access Protocol) 

There may well be other prefixes which are not listed here at this time. If you have a specific question about this 
post it to the netscape.devs-client-technical discussion group. 



1.10: Does Netscape client software support IMAP? 

Messenger, a component of Communicator, supports the Internet Message Access Protocol (IMAP) An 
interesting article available from a University of Washington server explains why IMAP is better than the Post 
Office Protocol (POP). The IMAP standard is available here. IMAP allows users to maintain remote folders 
increase flexibility in checking mail, and better management of offline messaging. Of course any IMAP client 
needs an IMAP-enabled server, such as the Netscape Messaging Server. 



1.11: Does Netscape client software support LDAP? 

Communicator supports the Lightweight Directory Access Protocol (LDAP)throughout its various components In 
addition to maintaining "addressbooks" LDAP becomes a valuable feature for integration with Conference and 
Calendar components. More information on LDAP is available from DevEdge Online. All LDAP client software 
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needs to connect to an LDAPserver, such as the Ngtsgape^ptoEy^en^. If you need a publicly accessable 
LDAP server for testing purposes, several of the larger "people finders" on the Internet have such servers online 
now. One URL to try is memberdir.netscape.com on port 389. 

1.12: Does Netscape client software support HOP? 

Lntemellnjer-O is a standard for facilitating communication between objects as defined by the 

Object Management Group. Netscape expects that over the next few years MOP will become as ubiquitous as 
HTTP and CGI, which will be supported in Navigator 4.0, a component of Communicator. Support for HOP will 
come through additions to the ! nt^et FpundMion Classes (IFCJ for Java developers The object request broker 
technology comes from Visjgenic Software, through their "VisiBroker technology. For questions pertaining to IFC 
please use the netscape.devs-ifc discussion group. 

1.13: How can I upload files via FTP using Navigator? 

Navigator gives us mechanisms useful in uploading files via File Transfer Protocol (FTP). Once logged onto an 
FTP server anonymously, users can simply drag and drop files into the Netscape document window to upload 
them. A prompt will appear asking the user if they want to upload the files. To log onto an FTP server usinq a 
username and password, assemble the URL like this: 

ftp: / /username :password@ftp. whatever-host . com/ 

Take care using this method; you might want to omit the password (Navigator will prompt you for it) so that the 
complete URL does not appear in Navigator's global history file. 

1 14: What is the Netscape Everywhere - Unlimited Distribution Program? 

The Netscape Everywhere - Unlimited Distribution program allows participants to distribute Netscape Navigator 
and Netscape Communicator Standard Edition to their customers and prospects with no licensing fees. An online 
applicajion and agreement allows participants to download multiple versions of Communicator and Navigator 
simply and easily. The distribution program allows participants maximum flexibility in deciding how, where, and 
when to distribute these world-class Netscape client products. For more information refer to the Unlimited' 
Distribution program FA Q . 

1.15: What did Netscape announce about Netscape Communicator 5.0 source code? 

On January 22, 1998, Netscape announced that Netscape Communicator Standard Edition 5.0 source code will 
be freely available for modification and redistribution. Netscape believes that harnessing the creative abilities of all 
Internet developers will be an unprecedented way to advance the features and quality of Netscape Communicator 
for all customers. Detailed license terms, additional information, and a developer release of Netscape 
Communicator Standard Edition 5.0 source code is scheduled to be available by March 31, 1998 from the 
Netscape DeyEdge site. For more information refer to the Netscape Communicator source code FAQ. 

1.16: How does Netscape client software support vCard? 

A vCard is a digital representation of a business card. Netscape Communicator supports vCard technology by 
allowing users to distribute their vCards, as well as use vCards for easy information entry into the Address Book. 
vCard technology was originally developed by the versit consortium and is now a standard maintained by the 
Internet Mail Consortium (IMC). 

1.17: Which platforms are supported in Netscape Communicator? 

Communicator is cross-platform client software, which means it works on many different platforms, whether they 
be Windows, Macintosh or Unix-based. You can find a complete list of the supported platforms in the 
Cpmmunicator FAQ. Communicator will eventually be made available on thin-clients by Navio, an independent 
Netscape affiliate which delivers Netscape client technology to a wide variety of consumer and non-PC devices. 
For questions about Navio and ports of Netscape client software to non-PC devices, please send email to 
info@navio.cqm. 
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1.18: What is Navigator's "cache" and how should I manage it? 

A "cache" (pronounced like "cash") temporarily stores information on your computer from Web paqes you've 
visited. If you later revisit a page that is stored in the cache, Navigator can retrieve the page from its cache more 
quickly than retrieving the page again from a location out on the network. More information on managing your 
cache is available in a Netscape Help TechNote. Background information is also available in the Navigator 
Handbook . Note that Netcaster, a Communicator component, maintains its own cache independent of Naviaator 
administrators can control the size of all of the client software cache files through Netscape Mission Control 

UGSKIOp . ~ 



1.19: How can I keep others from using my personal certificates in Navigator? 

Personal certificates are digitally-signed identification cards most commonly used on full service Intranets utilizino 
a certificateserver. Navigator allows you to password-protect your certificates, so that whenever they are 
requested, you must enter a password to use the certificate. You will find this option by pressinq the security 
button to launch the security dialog and then choosing "passwords" in the resulting menu 



1.20: What software is available to digitally sign scripts and applets? 

The Netscaj^JAR Packager is a tool that lets you package code in a Java ARchive(JAR) file A JAR file is a 
collection of files that you can sign digitally. Signed scripts and applets can reach beyond the traditional "sandbox" 
which limits the capabilities of executable, interpreted code. 



1.21. I've tried using Layers in Communicator, but what about style-sheet layout? 

men creating Communicator. Netscape answered needs expressed by its customers for absolute positionino 

SI'S? fr e f- J^'l ^ 3S d0ne thr0Ugh the introducti °n ° f Dynamic Layers Months later, in collaboration with the 
World Wide Web Consortium , Netscape and Microsoft have authored a specification to extend style sheets to 
include positioning capabilities. Netscape will support both methods of positioning for the forseeable future 



1.22: How can I support multiple users on one copy of Communicator? 

Using profiles, it is possible to toggle between multiple user preference settings upon startup of Communicator 
Profiles keep user settings suchas email address, name, certificates, etc., as well as mail and news folders and 
cache files. Use the Netscape User Profile Manager to keep track of your various user profiles 



1.23: What is canvas mode? 

Netscape Communicator's enhanced canvas mode lets Netscape Navigator 4.0 support true kiosk applications bv 
displaying pages without any browser toolbars, menus, or borders. This feature lets developers create kiosk 
applications like those already found in malls and airports and design pages that will immerse and guide the user 



1 .24: How can multiple employees share a commonly accessible address book? 

Any LDAP-based directory server can be used by Communicator for this purpose. Currently the best solution 
this is the Netscape Directory Server . 



1.25: How can I suppress the dotted line that appears around selected linked images? 

By placing the suppress=true attribute in your <A href= . . . . > tags, you will be able to eliminate the dotted 
line which appears around linked images when they are selected. This feature was introduced in Communicator 
PR3, and will not function in earlier beta releases of the software. 



1.26: Location independence: what is it and how is Netscape client software supporting it? 

Communicator supports profiles, a technology that allows multiple users to share the same copy of Communicator 
on any given machine. Communicator 4.5 introduced Roaming Access for profiles using an HTTP or LDAP Server 
for location independence. Using Mission Control Desktop 4.5, installers for network servers can also be created 
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1.27: How can I force a web page not to be cached on the Client? 

By using the <meta HTTP-EQUIv=»Pragma» CONTENT=»no-cache»> tag inside the <head> tag of your 
HTML page. y y 

1.28: What is SmartUpdate? 

SmartUpdate is a set of technologies that enable software to be installed in a secure manner usinq Netscaoe 
Communicator as a front end. Although any software can be installed using SmartUpdate, it is ideal for Navigator 
plug-ins and Java classes. To SmartUpdate-enable your software read the TechNote on SmartUpdate For an 
introduction to SmartUpdate, see lismgJA ' 

1.29: Sometimes I get "Data Missing" error, Why? 

With some pages, whenever the user tries to print/reload/resize/ViewSource the page, gets the following error: 
"Data Missing 

This document resulted from a POST operation and has expired from the cache. If you wish you can repost the 
form data to recreate the document by pressing the reload button". 

Basically this happens, if the document is dynamically generated in response to the POST data and if it 
contains the pragma no-cache header/metatag. In this case file will not be in the cache. Thus whenever user tries 
to prmt/reload/resize/ViewSource the page, browser will not be able to access the page again (either from local 
cache or from server) and it displays this error message. 

1.30: Can I use Navigator/Communicator as an ActiveX control? 

No, at present you can't use Navigator or Communicator as an ActiveX control. There is a project under wav to 
create an ActiveX wrapper for NGLayout, Netscape's New Generation Layout. 

1.31: How do I remove the single-pixel border from frames? 

To do this, you need to add the marginwidth=0 and marginheight=0 attributes to the body element in your 
page. For more information, see l-Pke|Border lechnote 

1.32: Can I launch Netscape Composer from HTML or JavaScript? 

No, at this moment it's not possible to launch Netscape Composer through JavaScript or HTML. 
Back to the Question Summary, or to the top . 



Section 2: Messenger 

1- How can I. mig rate from legacy mail systems (cc:Mail, Eudora, Notes, Exchange, PROFS) to Netscape 
Communicator? 

2. What format does Netscape Messenger store em ail in loyally? 

3. Is it possible to extend the capabilities of Messenger? 

4. How can ( launch the message composition window and populate fields like CC: or Subject ? 
5- Is there a wav to start th e Messenger InBox through a Hy per link in the Browser? 
6. Can I synchronize my Address Book and Mail with my Palm Pilot? 

How do I get rid of the "Welcome to Netscape Messenger"" pageTthat appears every time I start Messenger 



7 



2.1: How can I migrate from legacy mail systems (cc:Mail, Eudora, Notes, Exchange, PROFS) to Netscape 

http://developer.netscapexom/support/faqs/champions/client_tech.html 2/13/2004 



Page 7 oi l 2 



Communicator? 

Netscape Communicator provides an exciting new mail client called Messenger which uses open standards to 
deliver rich email. In order to assist those who may be migrating to Messenger from legacy messaging systems 
founded on propnetary technology such as cc:Mail, Eudora, Notes, Exchange or IBMPROFS Netscape has 
announced the release of a Migration Jpglkit. A discussion group has been created for comments on this new 
tool. 



2.2: What format does Netscape Messenger store email in locally? 

Mail is stored in a standard text file conforming to the Unix mbox format, which is simply plain ASCII text with mail 
body and header information. Messages encrypted with S/MIME are stored locally in encrypted form (althouah the 
headers remain in clear text). y 



2.3: Is it possible to extend the capabilities of Messenger? 

Netscape Communicator's Messenger component makes use of Composer, the HTML-editing component of 
Communicator. Therefore, message composition windows can hold Composer plug-ins but there is not any 
specific API in place for extending the mail and discussion features of Messenger and Collabra 



2.4: How can I launch the message composition window and populate fields like CC- or Subject ? 

Most folks are familiar with links containing an HREF beginning with mailto: that launch a message ' 
composition window. It is possible to specify in such a link information such as destination newsgroups for the 
message, the subject of the message, cc and bcc recipients, and more. For a complete overview of how to 
compose these types of mailto : links, read the View Source article by Robert Husted 



2.5. Is there a way to start the Messenger InBox through a HyperLink in the Browser? 

The simplest way to start Messenger is: 

<A HREF="mailbox: ">Open Messenger</A> 



In Navigator 2.0 and 3.0: 

mailbox : pathname 

mailbox : pathname? 
id=xxx 

mai lbox : pathname ? 
number =n 



mailbox : pathname? 
id=xxx&number=n 



refers to the folder itself. 

refers to a message by ID. 

refers to a message by number (the 
first message in the folder is 0, the 
second message is 1, etc.) 



is the name as the "number=n" form if 
and only if message N has the ID xxx; 
else it is the same as the "id=xxx" 
form. (This is for distinguishing 
between two messages with the same 
id.) 

4.0 broke this, making both the "id" and "number" parameters mandatory; changing the "number parameter from 
a ^message number* to *byte offset*; and making it impossible to refer to arbitrary files as mailboxes (you can 
only refer to files that are under your mail directory.) 



2.6: Can I synchronize my Address Book and Mail with my Palm Pilot? 

Yes, with Netscape Communicator 4.5 you can synchronize your mail and address book with your Palm Pilot. 
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2.7: How do I get rid of the "Welcome to Netscape Messenger" page that appears every time I start 
Messenger 4.5? 

You can either disable the Messenger Start Page or change the URL that it loads. 



To disable it: 



1 . Exit Netscape. 

2. Open Windows Explorer and go to your ...\Netscape\Users\{username}\ directory. 

3. Find the file named prefs.js and make a backup copy. 

4. Use Notepad or another text editor to open prefs.js. 

5. Add the following line on a line of its own: 

user_pref { "mailnews . start_page . enabled" , false ) ; 

6. If you typed in the above line, verify that it is exactly as shown above. Errors will cause this to fail to work 
and may result in a corrupted prefs.js file. 

7. Close the text editor and save changes. 

8. Restart Netscape. 



To change the URL: 



1. Follow steps 1-4 above. 

2. Add the following on a line of its own: 

user_pref ( "mailnews . start_page . url " , "ht tp : / /home . netscape . com/ " ) ; 

Replace http://h ome.n etscape.com/ with the full URL you wish to use instead. 

3. Verify that line is exactly as shown above, with the URL you wish to use in quotes. Errors will cause this to 
fail to work, and may result in a corrupted prefs.js file. 

4. Close the text editor and save changes. 

5. Restart Netscape. 



Back to the Question Summary, or to the top. 



Section 3: Client Preferences 

1. How can I change Navigator's default home page? 

2. Is it, possible to change Mail Preferenc on the Client programmatically? 

3. What is th„e..prefe js file an^ modify it? 



3.1. How can I change Navigator's default home page? 

To change the default page which is loaded at start-up in Navigator, modify your general preferences In 
Navigator 3, choose "Options" then "General Preferences" then "Appearance". In Communicator, choose "Edit" 
then "Preferences" then "General Preferences" then "Appearance". For developers who are frequently running a 
different version of Navigator, it can be very helpful to set your home page location to "about:" which will display 
version information in place of your default home page. 



3.2: Is it possible to change Mail Preferences on the Client programmatically? 

You can change any Communicator preference setting with proper security permissions. All preferences are 
exposed to JavaScript. Essentially, your signed script might do something like this: 



function GetNetscapePref {pref Key, def aultValue, warn) 
{ 

var pref; 

netscape . security. PrivilegeManager . enablePrivilege ( "UniversalPref erencesRead" 
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pref = navigator .preference (pref Key) ; 
if (Mpref) || (pref null)) 



{ 



if (warn) 

alert (getLocalString ( "The preference •') + pref Key + getLocalStrin 
from your preferences file and a default value has been used Pie 
your administrator.")); 
pref = defaultValue; 



return pref; 
} 



3.3: What is the prefs.js file and how can I modify it? 

Communicator's preferences are stored in the prefs.js file (Netscape Preferences File on the Mac) You can find a 
.descnptipn of this file, and you can modify it locally as a text file or using a signed JavaScript script with the 
proper privileges ena bled . v 

Back to the Question Sum mary, or to the top. 



Section 4: DDE & External Applications 

1 . How do I control Navigator from mv MS Windows ^ application? 

2 . How do I control Navigator from mv Macintosh 1 ** application? 

3. How do ! cpn 

4. I Ve developed a MipeLappli^tipn which works Jpcaily, but not over the network What's happening? 

5. How do I use WWWOpenURL to open a URL in a frame? 
6 • Ca n I post form data to a local a pplication? 

7. Can I restrict th^ 



4.1: How do I control Navigator from my MS Windows™ application? 

You can control Navigator from another application through the Netscape Client API (NCAPI) utilizing a platform 
specific method of inter process communication (IPC). On the Windows platform, this is accomplished both 
through DDE support and OLE! automation. 



4.2: How do I control Navigator from my Macintosh™ application? 

You can control Navigator from another application through the Netscape Client API (NCAPIJ utilizing a platform 
specific method of inter process communication (IPC). On the Mac OS platform, this is accomplished through 
Macintosh Apple Events. For more information, see the Macintosh remote-control sp ecification Netscape has 
announced that they will be supporting the next generation Apple operating system in Netscape client software 



4.3: How do I control Navigator from my Unix application? 

You can control Navigator from another application through the Netscape Client API (NCAPI) utilizing a platform 
specific method of inter process communication (IPC). On Unix platforms, this is accomplished through X 
properties. ~ 



4.4: I've developed a helper application which works locally, but not over the network. What's happening? 

Frequently, developers create helper applications which seem to work fine when tested locally, but when content 
is downloaded through a Web server, Navigator fails to launch the desired helper application. This is the result of 
incorrect configuration on the server end. In this scenario, the Webserver is unaware of the MIME type it should 
associate with the file extension in question, so it defaults to the fallback MIME time (normally text/plain) To avert 
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this problem, add the MIME t ype to your Web server. 

4.5: How do I use WWW_OpenURL to open a URL in a frame? 

To load a URL in a particular frame, first get all the available Windowlds by calling WWW ListWindows Next steD 
is to get the Windowld for required frame. WWW_GetWindowlnfo will give the URL title a"nd framename for the 
specified Windowld. Get this information for each of the Windowlds from the list and use them to choose the 
Windowld of the frame that you are interested. Use this Windowld with the WWWjDpenURL to load the URL. 

4.6: Can I post form data to a local application? 

Yes. This is possible with NCAPI OLE/DDE. Register the protocol (say "local") with DDE/OLE calls Specify this 
protocol in your html file form tag as: 

<FORM NAME="f orml " METHOD="POST" ACTION="local : //Information'^ 

After submission of the form this will invoke the appropriate OLE/DDEserver and calls its function with the data 
along with the URL. 

4.7: Can I restrict the user access to only approved URLs? 

Yes. One way is by registering all the protocols (http.ftp, ...) to the external application using the NCAPI OLE/DDE 
RegisterProtocolcalls. When the user tries to access the page, your application gets the URL now filters it if 
allowed then UnRnregisterProtocol temporarily and use WWWJDpenUrl to access the data. There might be some 
practical problems in choosing the appropriate method. OLE does not give any method to unregister the protocol 
you need to use registry calls to delete it from the registry. Using DDE, the problem might be that the DDE server' 
should be running or else the browser will allow the access. 

Back to the Question Summary, or to the tog. 



5: Piug-ins & Extending the Client 

1 • How do I build plugjns for Netscape Navigator? 

2. Are there any Improvements ^t^ 

3. Can I register mv own protocol with Navigator? 

4. How do I extend the capabilities of Composer? 

5. Can I m^ and toolbar? 

6. Can I modify Navigator to lock out certain features? 

7. How can I make features such as "Excite Direct" or other custom addition s t o Navigator's Ul? 

8. Where can I. geUhe current user profile? 

9. How can I launch the d^ 



5.1: How do I build plugins for Netscape Navigator? 

The Netscape Plug-in API allows third parties' to extend the Navigator component of Netscape Communicator with 
native support for new data types and additional features. Plug-ins appear as additional capabilities ofthe 
Netscape client, indistinguishable to the user from the baseline features. LiveConnect allows plug-ins to be 
controlled by Java and JavaScript. For more information and a download link for the Plug-in SDK, take a look at 
the Plug-ins Developer Central page. You'll find the latest Netscape plug-in documentation in the Plug-in Guide 
which has been updated and expanded for Communicator 4.0. For information about using LiveConnect, or about 
LiveConnect-related Java or JavaScript commands, see LiveConnecting Plug-ins with Java . Netscape also 
makes some &lug r jnresources available. Those interested in building plug-ins for Netscape Communicator should 
see the question below which explains improvements to the plug-in API for Communicator. Developers can also 
build plug-insfor Communicator components Conference and Composer. 
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5.2: Are there any improvements to the Plug-in API in Communicator? 

Communicator introduces powerful new features to plug-ins, allowing for windowless plug-ins new features to 
auto-install pug-.n components. For more information, see the Communicator 4.0 Plug-in Guide as well as Usina 
JARAnjstaJJati^ for information about Autolnstall --"aJiLiauige, as well as Using 



5.3: Can I register my own protocol with Navigator? 

It is possible to use NCAPI to register your own protocol. For instance, if you want to have all calls to 
"mySuperProtocol:" handled by your application, you should use NCAPI methods to get that functionality 
However, it is not possible to register a viewer protocol on the Unix platform releases of Navigator 



5.4: How do I extend the capabilities of Composer? 

It is possible to extend the capabilities of Composer, a Communicator component by using a Composer plua-in 
Composer Plug-ins are Java classes which add additional HTML-editing functionality to the Netscape 
Communicator Composer module. DevEdge Online makes available both the Composer Plug-in Guide and the 
Composer Plug-in Kit (SDK), available from the Plug-ins Documentation page." 



5.5: Can I make additions to the Navigator menu and toolbar? 

In Navigator 3.0, it is possible to make additions to the Navigator menu and toolbar using Mission Control DesktOD 
formerly known as the Administration Kit). Navigator 4.0. a Communicator component, supports ranvas mode 
Using canvas mode, it ispossible to define your own interface. For special customization outside of the realm 
mentioned, an OEM agreement gives you access to special undocumented hooks in Netscape client software 



5.6: Can I modify Navigator to lock out certain features? 

It is possible to lock out certain features such as Java and JavaScript to Navigator users through Mission Control 
Desktop (formerly known as the Administration Kit). To block out access to certain Web sites use "of a proxy 
server is recommended. In addition to Mission Control Desktop, the free Client Customization Kit allowsbrowser 
customization, but Mission Control Desktop allows remote administration of clients. 



5.7: How can I make features such as "Excite Direct" or other custom additions to Navigator's Ul? 

It is possible to extend the user interface of Navigator beyond what is possible with Mission Control Desktop 
through OEM agreements. These agreements allow developers low-level access to the Navigator code which 
would permit functionality similar to that in Excite Direct, which places a search field in the Navigator chrome 



5.8: Where can I get the current user profile? 

This information is stored in the registry. Current user name will be available at the key 

H KEY_LOCAL_MACHINE/SOFTWARE /Nets cape /NetscapeNavi gat or /Users with name Cur 

External applications can access this information using Registry function RegQueryValExQ 



5.9: How can I launch the default browser from an external Windows application? 

The simplest and best way to launch the default browser is by using ShellExecute and specifying a URL in the 
IpFile parameter. This avoids searching for the default browser and its location in the registry. 

E.g., ShellExecute (hWnd, NULL, "http://www.netscape.com", "", "", SW SHOWNORMAL) ; 



Back to the Question Summary, or to the top. 
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• Netscape Client AP I (NCAPI) F AQ 

• The Unofficial Netscape FAQ 

• HTML Refere nce Guide 

• HTML Layer s Documentation 

• HTML Tags Sorted bv Navigator Release 

• DevEdqe Online Sample Code Library 

VIEW SOURCE ARTICLES 

• Unleashing the Power of mailto URLs 

• DHTML De mystified: Capturing Key Presses and Writing to Onscreen Lay ers 

• Bro wser-Friendly Drag g ing in Dy n amic HTML 

• Netscape Client Plug -ins 

• Scripting Layer Effects and Transitions 

• Bringing Images to Life with JavaScri pt 

MEMBERS RESOURCES 

Client Technical Newsgroup 

Previous revisions of this FAQ where complied by Angus Davis . 

Content contributed voiuntariiy by our awesome DevEdge Champions based on peer-to-peer discussion in the 
DevEdge newsgroups. While Netscape hosts them, it does not offer any direct developer support via the 
newsgroups. To find out where to get support from Netscape, please visit our Support Overview page. 

This FAQ is intended as a developer resource. Any reference to third parties or third-party products should not be 
construed as an endorsement by Netscape Communications Corporation. 

For the latest technical information on DevEdge Archive products, go to: http://developer.netsca pe cnm 

For more Internet development resources, try Netscape TechSearch . 

Copyright © 1999 Netscape. Cpmmunicatip^ 
This site powered by: Netscape. Enterprtse^e[ver and Netscape^ Compass. Server. 
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All messages from thread 

From; LiojMLSchieeer (taeL^ Messaae 1 in n™n 

Subject: Toolbar like IE4 ; message i in thread 

Newsgroups: m icroso ft.public.vc.mfc 

Date: 1998/04/23 ^ . 

View this artirJp only 

With the technology preview for VisualC++ 5, is there any way to have 
toolbar like IE4 and not rebar like IE3. 
Does someone have example? 

I have tried some code from www.codequru.com but all i have is rebar (it 
use CToolBar class) 

Lionel Schiepers ( Lionel.Schiepers@advalvas.be ) 
Student at HEPL Rennequin Sualem in computer science 
In.Pr.E.S Seraing (belgium) 



From: Ser gio Lopes (gerqio lopesQmail.telepac pt) Message 2 in thread 
Subject: Re: Toolbar like IE4 s 
Newsgroups: microsoft.public.vc.mfc 

Date: 1 998/04/23 ^w JM s article only 

On Thu, 23 Apr 1998 13:52:28 +0100, "Lionel Schieper" 
<Lionel . Schiepers@advalvas .be> wrote: 

>With the technology preview for VisualC++ 5, is there anv wav to have 
>toolbar like IE4 and not rebar like IE3. 
>Does someone have example? 

>I have tried some code from www.codequru.com but all i have is reba- (it 
>use CToolBar class) 



The technology preview installs a sample of an IE4 style 
minibrowser . . . check it out at : 

\ Program Files \DevStudio\preview\vc\samples \mf cie 

bye, 
Sergio Lopes 
MCSD 

sergio . lopes@mail . telepac . pt 



From: Charles Steinhardt ( Csteinhardt@omQHnc.COIW 
Subject: Re: Toolbar like IE4 
Newsgroups: miciosoft.public.vc.mfc 
Date: 1998/04/23 

Take a look at the MSDN under: 

The Rebar Control: Using a Coolbar in Your Application 
Nancy Winnick Cluts 
Developer Technology Engineer 
Microsoft Corporation 

October 1996 

Updated June 24, 1997 



Message 3 in thread 
View this article onjy 
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Contents 

What Is a Coolbar? 
Creating a Coolbar 
Messages and Notifications 
Summary 

Abstract 

One of the controls created for Internet Explorer 3.0 is the Rebar 
control. It is most commonly known, however, as the coolbar. A coolbar 
contains child windows such as toolbars, combo boxes, and bitmaps, and 
manages the size and position of the child windows it contains. Once 
you create the child windows and assign them to the coolbar, the child 
windows are displayed in it. This article demonstrates how to create 
and use a coolbar. The sample that accompanies this article, 
creatively named "Rebar, " was written using Microsoft® Visual C++® 
version 4.2, the Win32® Software Development Kit (SDK), and the 
ActiveX™ SDK for Internet Explorer 3.x. If you are going to use the. 
coolbar in an application targeted to Internet Explorer 4.0, use the 
Internet Client SDK (INet SDK) instead of the ActiveX SDK. 

Charles Steinhardt [MVP] 

From: Daniel Weber ( sysdev^qmx.net ) Message 4 in thread 

Subject: Re: Toolbar like IE4 
Newsgroups: microsoft.public.vc.mfc 

Date: 1 998/04/23 Vjew this article only 

Lionel Schieper wrote in message . . . 

>With the technology preview for VisualC++ 5, is there any way to have 
>toolbar like IE4 and not rebar like IE3. 

The IE3 and IE4 Toolbars are the same. Both are ReBarWindow32-Controls . Only 
the gripper has been changed! 



Need a web-solution? 
Visit the WebFX-site! 



Daniel Weber 
sysdev@gmx . net 

£ PI LL w f x. home .m l . org 



©2004 Gooele 
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Creating Custom Explorer Bars, Tool Bands, and Desk Bands 



The Explorer Bar was introduced with Microsoft Internet Explorer 4.0 to provide a display area adjacent to the 
browser pane. It is basically a child window within the Internet Explorer window, and it can be used to display 
information and interact with the user in much the same way. Explorer Bars are most commonly displayed as a 
vertical pane on the left side of the browser pane. However, an Explorer Bar can also be displayed horizontally 
below the browser pane. 



'5 Welcome to Microsoft's Homepage - Microsoft Internet Explorer - Da... (3[§)f*[ 



File Edit View Favorites Tools Help 




There is a wide range of possible uses for the Explorer Bar. Users can select which option they wish to see in 
several different ways, including selecting it from the Explorer Bar submenu „,' the View menu, or clicking a 
toolbar button. Internet Explorer provides several standard Explorer Bars, including Favorites and Search. 

One of the ways you can customize Internet Explorer is by adding a custom Explorer Bar. When implemented 
and registered, it will be added to the Explorer Bar submenu of the View menu. When selected by the user 
the Explorer Bar's display area can then be used to display information and take user input in much the same 
way as a normal window. 
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3 Windows XP 




To create a custom Explorer Bar, you must implement and register a band object. Band objects were introduced 
with vers.on 4.71 of the Shell and provide capabilities similar to those of normal windows. However because 
they are Component Object Model (COM) objects and contained by either Internet Explorer or the Shell thev are 
.mplemented somewhat differently. Simple band objects were used to create the sample Explorer Bars displayed 
m the first graphic. The implementation of the vertical Explorer Bar sample will be discussed in detail in a later 
section. 

The following topics are discussed. 

• IpqI Bands 

• Desk. Bands 

• Impiemen ti ng Band. Objects 

• Related Topics 

Tool Bands 

A tool band is a band object that was introduced with Internet Explorer 5 to support the Microsoft Windows radio 
toolbar feature. The Internet Explorer toolbar is actually a rebar control that contains several toolbar controls By 
creating a tool band, you can add a band to that rebar control. However, like Explorer Bars, a tool band is a 
general purpose window. 
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3 Microsoft Internet Explorer 




Users display a toolbar by selecting it from the Toolbars submenu of the View menu or from the shortcut mpn„ 
that is displayed by right-clicking the toolbar area. shortcut menu 

Desk Bands 

Band objects can also be used to create desk bands. While their basic implementation is similar to Explorer Bars 
desk bands are unrelated to Internet Explorer. A desk band is basically a way to create a dockable window on ' 
the desktop. The user selects it by right-clicking the taskbar and selecting it from the Toolbars submenu 



View 




Open Folder 




* Show Text 




✓ Show Title 




Close Toolbar 





Toolbars 




Cascade Windows 
Tile Windows Horizontally 
Tile Windows Vertically 
Show the Desktop 



Task Manager 



Address 
Links 
Desktop 
✓ Quick Launch 



i/ Sample Desk Band 



New Toolbar... 



U. start 



Lock the Taskbar 
Properties 



; Sample Desk Band 





My Computer Recycle Bin 



Initially, desk bands are docked on the taskbar. 






Notepad M y Computer Recycle Bin 



'j start 



Sample Desk Band - Sample Desktop Band 



The user can then drag the desk band to the desktop, and it will appear as a normal window. 
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Sample Desk Band 



Sample Desk Band 



r '. 





Notepad My Computer Recycle Bin 

Implementing Band Objects 

The following topics are discussed. 

• Band Object Basics 

• .Band^e^sJ^a]y.on 

• A S [mpieE ;xa i m p[e j3f _a jCus torn. ExplonerBar 
Band Object Basics 

Although they can be used much like normal windows, band objects are COM objects that exist within a 
container. Explorer Bars are contained by Internet Explorer, and desk bands are contained by the Shell. While 
they serve different functions, their basic implementation is very similar. The primary difference is in how the 
band object is registered, which in turn controls the type of object and its container. This section discusses those 
aspects of implementation that are common to all band objects. See A Simple Example of a Custom Explorer Bar 
for additional implementation details. 

In addition to IUnknown and IC lass Factory, all band objects must implement the following interfaces. 

• IDeskBand 

• IObiectWithSite 

• IPsrsistStream 

In addition to registering their class identifier (CLSID), the Explorer Bar and desk band objects must also be 
registered for the appropriate component category. Registering the component category determines the object 
type and its container. Tool bands use a different registration procedure and do not have a category identifier 
(CATID). The CATIDs for the three band objects that require them are: 

Band Type Component Category 

Vertical Explorer Bar CATID_InfoBand 
Horizontal Explorer Bar CATID_CommBand 
Desk Band CATID_DeskBand 

See Band Registratipn for further discussion of how to register band objects. 

If the band object is to accept user input, it must also implement IlnputObi ect. To add items to the shortcut 
menu for Explorer Bar or desk bands, the band object must export IContextMenu . Tool bands do not support 
shortcut menus. 

Because band objects implement a child window, they must also implement a window procedure to handle 
Windows messaging. 
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Band objects can send commands to their container through the container's IOIeCommandTarget interface To 
obtain the interface pointer, call the container's IlnputOWectSite:: Query Interface method and ask for 
IID.IOIeCommanoTarget. You then send commands to the container with IOIeCommandTarget- 'Exec The 
command group is CGID.DeskBand. When a band object's GetBandlnfo method is calied, the container uses the 
dwBandID parameter to assign the band object an identifier that is used for three of the commands Four 
lOleCommandTarget::Exec command identifiers (IDs) are supported. 

• DBID.BANDINFOCHANGED 

The band's information has changed. Set the pvaln parameter to the band identifier that was received in the 
most recent call to GetBandlnfo. The container will call the band object's GetBandlnfo method to request 
the updated information. M 

• DBID_MAXIMIZEBAND 

Maximize the band. Set the pvaln parameter to the band identifier that was received in the most recent call 
to GetBandlnfo. 

• DBID.SHOWONLY 

Turn other bands in the container on or off. Set the pvaln parameter to the VTJJNKNOWN type with one of 
the following values: 

Value Description 

punk A pointer to the band object's IUnknown interface. All other desk bands will be hidden. 

0 Hide all desk bands. 

1 Show all desk bands. 

• DBID_PUSHCHEVRON 

Version 5 - Dis P ,av a ch evron menu. The container sends an RB PUSHChevrhm message, and the band 
object receives an RBN CHEVRONPUSHFD notification that prompts it to display the chevron menu Set the 
IOIeCommandTarget::Exec method's nCmdExecOpt parameter to the band identifier received in the most 
recent call to GetBandlnfo. Set the IOIeCommandTarget::Exec method's pvaln parameter to the VT.I4 
type with an application-defined value. It passes back to the band object as the lAppValue value of the 
RBN.CHEVRONPUSHED notification. 

Band Registration 

A band object must be registered as an OLE in-process server that supports apartment threading. The default 
value for the server is a menu text string. For Explorer Bars, it will appear in the Explorer Bar submenu of the 
Internet ExplorerView menu. For tool bands, it will appear in the Toolbars submenu of tne Internet 
ExplorerView menu. For desk bands, it will appear in the Toolbars submenu of the taskbar's shortcut menu. As 
with menu resources, placing an ampersand (&) in front of a letter will cause it to be underlined and enable 
keyboard shortcuts. For example, the menu string for the vertical Explorer Bar shown in the first graphic is 
"Sample &Vertical Explorer Bar". 

In general, the basic registry entry for a band object will appear as follows. 

HKEY_CLASSES_ROOT 
CLSID 

{Your Band Object's CLSID GUID} 

(Default) = Menu Text String 
InProcServer32 

(Default) = DLL Pathname 

ThreadingModel= Apartment 

Tool bands must also have their object's CLSID registered with Internet Explorer. To do this, assign a value 
under HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Toolbar named with the tool band 
object's CLSIDglobally unique identifier (GUID) as shown here. Its data value is ignored, so the value type is 
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unimportant. 

HKEY_LOCAL_MACHINE 
Software 

Microsoft 

Internet Explorer 
Toolbar 

{Your Band Object's CLSID GUID} 

There are several optional values that can also be added to the registry. For instance, the following value is 
necessary if you wish to use the Explorer Bar to display HTML The value shown is not an example, but the actual 
value that should be used. 

HKEY_CLASSES_ROOT 
CLSID 

{Your Band Object's CLSID GUID} 
Instance 

CLSID 

(Default) = {4D5C8C2A-D075-11DO-B416-O0CO4FB90376} 

Used in conjunction with the value shown above, the following optional value is also necessary if you wish to use 
the Explorer Bar to display HTML. This value should be set to the location of the file that contains the HTML 
content for the Explorer Bar. 

HKEY_CLASSES_ROOT 
CLSID 

{Your Band Object's CLSID GUID} 
Instance 

InitPropertyBag 

UrI 

Another optional value defines the default width or height of the Explorer Bar, depending on whether it is vertical 
or horizontal, respectively. 

HKEY_CURRENT_USER 
Software 

Microsoft 

Internet Explorer 

Explorer Bars 

{Your Band Object's CLSID GUID} 
BarSize 

The BarSize value should be set to the width or height of the bar. The value requires eight bytes and is placed in 
the registry as a binary value. The first four bytes specify the size in pixels, in hexadecimal format, starting from 
the leftmost byte. The last four bytes are reserved and should be set to zero. 

As an example, the full registry entries for an HTML-capable Explorer Bar with a default width of 291 (0x123) 
pixels are shown here. 

HKEY_CLASSES_ROOT 
CLSID 

{Your Band Object's CLSID GUID} 

(Default) = Menu Text String 
InProcServer32 

(Default) = DLL Pathname 

ThreadingModel^ Apartment 
Instance 

CLSID 

(Default) = {4D5C8C2A-D075-11DO-B416-0OCO4FB90376} 
InitPropertyBag 
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Url= Your HTML File 

HKEY_CURRENT_USER 
Software 

Microsoft 

Internet Explorer 

Explorer Bars 

{Your Band Object's CLSID GUID} 

BarSize= 23 01 00 00 00 00 00 00 

IZTtrSTvT trati ° n °lr CATID programmatically. Create a component categories manager 

object (CLSID.StdComponentCategonesMgr) and request a pointer to its ICatRegister interface Pass the band 
object's CLSID and CATID to ICaffiegiste r; rReQisterOasSlmp .r^H^ ~ "terrace. Pass the band 

A Simple Example of a Custom Explorer Bar 

This example goes through the implementation of the sample vertical Explorer Bar shown in the introduction It 
^ ^ ° bj6CtS Sample COde < which can »* found in the Microsoft Platform Software Development 

■ , ! ?: . C ° mP S ° UrCe C ° de ' WhiCh alS ° im P |ements a horizontal Explorer Bar and a desk band is 
included here for reference. See the sample code, CommBjmdxpj, and PeskBand.c PPr for details on the' 
implementation of the horizontal Explorer Bar and desk band objects. 

The basic procedure for creating a custom Explorer Bar is as follows. 
1- Implement the functions needed by the DLL. 

2. Implement the required COM interfaces. 

3. Implement any desired, pptipnaj .COM. interfaces. 

4. Register the object's CLSIDand, if required, component category. 

5. Create a child window of Internet Explorer, sized to fit the Explorer Bar's display region. 

6. Use the child window to display infor m ation and interact with rhp near 

The very simple implementation used in the Explorer Bar sample could actually be used for either type of 
Explorer Bar, or a desk band, by simply registering it for the appropriate component category More 
soph.sticated implementations will need to be customized for each object type's display region and container 
However, much of this customization can be accomplished by taking the sample code and extending it by 
applying familiar Windows programming techniques to the child window. For example, you can add controls for 
user interaction, or graphics for a richer display. 

DLL Functions 

All three objects are packaged in a single dynamic-link library (DLL), which exposes the following functions. 

• DIIMain 

• QljCanUnloadNow 

• DIIGetClassObject 

• DIIReoisterServer 

These functions can be found in BandObjs.cpp and serve all three band objects. The first three functions are 
standard implementations and will not be discussed here. The Class Factory implementation is also standard 
and can be found in CIsFact.c pp. 

Required Interface Implementations 

The vertical Explorer Bar sample implements the four required interfaces: IUnknown, IObjectWithSite 
IPersistStream, and IDeskBand as part of the CExpiorerBa_r class. The constructor, destructor and ' 
IUnknown implementations are straightforward, and will not be discussed here. See the sample code for 
details. 
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The following interfaces are discussed in detail. 

• IObje^ithSite 

• IPersi stS tream 

• IpeskBand 

IObjectWithSite 

When the user selects an Explorer Bar, the container calls the corresponding band object's 
IObjertM^ method. The punkSite parameter will be set to the site's IUnknown pointer. 

In general, a SetSite implementation should perform the following steps: 

1. Release any site pointer that is currently being held. 

2. If the pointer passed to SetSite is set to NULL, the band is being removed. SetSite can return S_OK. 

3. If the pointer passed to SetSite is non-NULL, a new site is being set. SetSite should do the following: 

1. Call Querylnterface on the site for its IOLeMndow interface. 

2. Call IOieWjndpw:^ to obtain the parent window's handle. Save the handle for later use 
Release IOIeWindow if it is no longer needed. 

3. Create the band object's window as a child of the window obtained in the previous step Do not create it 
as a visible window. c 

4. If the band object implements IlnputObject, call Querylnterface on the site for its IlnDut&bjectSite 
interface. Store the pointer to this interface for use later. 4 

5. If all steps are successful, return S_OK. If not, return the OLE-defined error code indicating what failed. 

The Explorer Bar sample implements SetSite in the following way. In the following code m_pS/re is a private 
member variable that holds the IlnputObjectSite pointer and m^hwndParent holds the parent window's 
handle. 

Show Example 

The sample's GetSite implementation simply wraps a call to the site's Querylnterface method, using the site 
pointer saved by SetSite. 

STDMETHODIMP CExplorerBar : : GetSite (REFIID riid, LPVOID *ppvReturn) 
*ppvReturn = NULL; 
if (m_pSite) 

return m_pSite->QueryInterf ace (riid, ppvReturn) ; 



return E FAIL; 



} 



Window creation is handled by the private Register AndCreateWindow method. If the window does not exist, this 
method creates the Explorer Bar's window as an appropriately sized child of the parent window obtained by 
SetSite. The child window's handle is stored in m_hwnd. 

Show Example 
IPersistStream 

Internet Explorer will call the Explorer Bar's IPersistStream interface to allow the Explorer Bar to load or save 
persistent data. If there is no persistent data, the methods must still return a success code. The 
IPersistStream interface inherits from I Persist , so five methods must be implemented. 



http://msdn.microsoft.com/lito^ 2/13/2004 



^ ^ciiw i>aiiu^ v w iiiauws explorer ana co... Page 9 oi 1 1 



• IPersist::GetClassID 

• iPersjstStrea m : : IsDi rty 

• IPersjstStrea m:„: Load 

• I Persists t ream i:.:Saye 

• IPejrsLstSt^^^ 



The Explorer Bar sample does not use any persistent data and has only a minimal implementation of 
IPersistStream. IPersist::GetClassID returns the object's CLSID(CLSID_SampleExplorerBar) and the 
remainder return either S.OK, S_ FALSE, or E.NOTIMPL. See the IPersistStream implementation'* the sample 
code for details. M 

IDeskBand 

The IDeskBand interface is specific to band objects. In addition to its one method, it inherits from 
IDockinaWindow. which in turn inherits from IOieWindow. 

There are two IOieWindow methods: GetWindoyy and ContextSensitiveHelp. The Explorer Bar sample's 
implementation of GetWindow returns the Explorer Bar's child window handle, m_hwnd. Context-Sensitive Helo 
is not implemented, so IOIeWindow::ContextSensitiveHelp returns E_NOTIMPL. 

The IDockingWindow interface has three methods. 

• Show DW 

• CloseDW 

• ResizeBorderDW 

The ResizeBorderDW method is not used with any type of band object and should always return E NOTIMPL 
The ShowDW method either shows or hides the Explorer Bar's window, depending on the value of its 
parameter. 

Show Examp le 

The CloseDW method destroys the Explorer Bar's window. 

STDMETHODIMP CExplorerBar :: CloseDW ( DWORD dwReserved) 
{ 

ShowDW (FALSE) ; 

if (IsWindow(m_hWnd) ) 

DestroyWindow (m_hWnd) ; 

m_hWnd = NULL; 

return S OK; 



The remaining method, GetBandlnfo, is specific to IDeskBand. Internet Explorer uses it to specify the 
Explorer Bar's identifier and viewing mode. Internet Explorer also may request one or more pieces of information 
from the Explorer Bar by filling the dwMask member of the DESKBAND INFO structure that is passed as the third 
parameter. GetBandlnfo should store the identifier and viewing mode and fill the DESKBANDINFO structure 
with the requested data. The Explorer Bar sample implements GetBandlnfo as shown in the following code 
snippet. 

* 

Show Example 

Optional Interface Implementations 

There are two interfaces that are not required, but that may be useful to implement: IlnputObject and 
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IContextMenu. The Explorer Bar sample implements IlnputObject. Refer to the documentation for 
information on how to implement IContextMenu. 

IlnputObject 

The IlnputObject interface must be implemented if a band object accepts user input. Internet Explorer 
implements IlnputObjectSite and uses IlnputObject to maintain proper user input focus when it has more 
than one contained window. There are three methods that need to be implemented by an Explorer Bar. 

• UIActivatelO 

• HasFocusIQ 

• TranslateAcceleratorlO 

Internet Explorer calls UIActivatelO to inform the Explorer Bar that it is being activated or deactivated. When 
activated, the Explorer Bar sample calls SetFocjis to set the focus to its window. 

Internet Explorer calls HasFocusIO when it is attempting to determine which window has focus. If the Explorer 
Bar's window or one of its descendants has focus, HasFocusIO should return S_OK. If not it should return 
S_FALSE. 

TranslateAcceleratorlO allows the object to process keyboard accelerators. The Explorer Bar sample does not 
implement this method, so it returns S_ FALSE. 

The sample bar's implementation of IlnputObjectSite is as follows. 
Show Example 

CLSID Registration 1 

As with all COM objects, the Explorer Bar's CLSID must be registered. For the object to function properly with 
Internet Explorer, it must also be registered for the appropriate component category (CATIDJnfoBand) 
Registration is handled by DIIRegisterServer. The relevant code section for the vertical Explorer Bar is shown 
in the following code snippet. 

Show Example 

Registration of band objects uses normal COM procedures and is handled by a private function, RegisterServer. 

In addition to the CLSID, the band object server must also be registered for one or more component categories 
This is actually the main difference in implementation between the vertical and horizontal Explorer Bar samples 
This process is handled by creating a component categories manager object 

(CLSID.StdComponentCategoriesMgr) and using the ICatReoister: :ReQisterClassImDlCateooriP«; method to 
register the band object server. In this example, component category registration is handled by passing the 
Explorer Bar sample's CLSID and CATID to a private function, ReoisterComCat as shown in the following code 
snippet. 

Show Example 

The Window Procedure 

Because a band object uses a child window for its display, it must implement a window procedure to handle 
Windows messaging. The band sample has minimal functionality, so its window procedure only handles five 
messages: 

• WM IMCCREATE 

• WM PAINT 

• WM C OMMA ND 

• WM_SEIFOCUS 

• WM_KILLFOCUS 
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The procedure can easily be expanded to accommodate additional messages to support more features. 
Show Example 

^h W ^ M T D hand f SimP,Y r6tUrnS 2er0 " The WM - PAINT handler creates the simple text display shown 
in the Explorer Bar example in the introduction, u.bpiay snown 

Show Exam ple 

The WM SETFOCUS and WM JCILLFOCUS handlers inform the site of a focus change by ca.ling the site's 
QnFocusChange 15 method - 9 ste s 

Show Example 

Band objects provide a flexible and powerful way to extend the capabilities of Internet Explorer by creatine, 
custom ^Plorer Bars. Implementing a desk band enables you to extend the capabilities of normal windows 
Although some COM programming is required, it ultimately serves to provide a child window for your use^ 
interface. From there the bulk of the implementation can use familiar Windows programming techniques While 
the example d.scussed here has only limited functionality, it illustrates all the necessary features of a band 
object and it can be readily extended to create a unique and powerful user interface. 

Related Topics 

• BancLO bjecjLIm Piemen tat ign Sample 
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Developers Get Early IE 5 



Wired News Report 



Story location: http.V/www.wiredxom/news/technoIogy/O, ] 282, 1 2936,00.html 
06:04 PM Jun. II, 1998 FT 

The war of the 4.0 browsers may seem like a distant memory, but with the 
trickling out of new features in Netscape and Microsoft's new browsers, 
things may start spicing up for the battle-nostalgic. 

Netscape (NSCP) recently unveiled its "smart" browser intentions, and now 
Microsoft (MSFT) has released an early developer preview of Internet 
Explorer version 5.0. 

The company said the release is only intended to give developers a head 
start with the new features. To get it, developers need to complete the 
company's online registration form. 

Under the theme of easier-to-build Web applications, Redmond is touting 
better manageability and an enhanced development platform via three 
categories of features: faster page rendering and data processing, enterprise- 
readiness, and extensibility and componentization features. 

In the faster rendering and processing category, IE 5's support for "fixed" 
table layouts will render tables much faster, Microsoft says. That's because 
the browser can display the table without first calculating the minimum and 
maximum size of table cells. Table content will be displayed on the page 
while the rest of the table is still loading. 

To take advantage of networks that use caching, a new header feature 
ensures that IE 5 will only circumvent a cache when a page has expired, as 
indicated by support for the "HTTP-Expires" header. Where caches are' 
being used, this technique is designed to retrieve pages faster from nearby 
cache servers and reduce network traffic. 

The browser is also capable of rendering very large documents faster, 
Microsoft said. A more efficient rendering engine promises better handling 
of pages built with Dynamic HTML or using "DataBinding" technology. 

The new release is XML-capable as well, allowing XML code to be 
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embedded in pages as data or meta-data. XML tags can also be coded within 
the page's HTML, Microsoft said, and cascading-style sheet properties can 
be applied to this content to control their appearance. 

For third-party applications seeking to display Web content within their own 
interfaces, IE5 accommodates "browser-less" development. Thus developers 
can create any application - a calculator or recipe collection, for example - 
that renders HTML and other code but doesn't depend on browser software. 

Related Wired Links: 



Netscape's 'Smart' Browser 
l.Jun.98 

No Java in IE5's Base-Level Download? 

20.Apr.98 

Explorer Icon: 'I'll Be Back' 
14.Apr.98 

m 
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Browser extensions allow developers to provide easy access to their browser enhancements by adding elements 
(like an Explorer Bar) to the default user interface. Introduced in Microsoft® Internet Explorer 4 0 this feature 
enables developers to create Explorer Bars and add entries into the standard context menus. Beginning with 
Internet Explorer 5, this feature allows developers to add entries into the Tools menu and buttons to the toolbar. 
• Benefits 



Scenarios 
Related Topics 



So what are the benefits of utilizing browser extensions? Internet Explorer 4.0 allowed developers to create 
Explorer Bars (also known as Browser Bands and Communication Bands) and add entries to the standard context 
menus. Beginning with Internet Explorer 5, browser extensions allow developers to provide access to Microsoft 
Win32®; applications, scripts, and Explorer Bars directly from the Internet Explorer user interface. Access can " 
- be provided from: 

• Menu items in the Tools menu 

• Toolbar buttons 

These additions are enhancements to the existing user interface, so there will be no negative effect on the end- 
user's experience. 

Scenarios 

Let's say you've implemented an Explorer Bar that displays financial information (like a stock ticker or currency 
exchange rates) that you want to provide for your customers. Instead of having access to your Explorer Bar 
buried in a menu, you can add a toolbar button directly to the Internet Explorer user interface. Now all your 
customers have to do is click the button and your Explorer Bar will display. 

Related Topics 

The following list contains links to topics related to using browser extensions. 
Overviews 

• Creating Custom Explorer Bars. Tool Bands , and Desk Bands 

• Explorer Bar Style Guide 

• Toolbar Button Style Guide 

• Implementing a C u stom Do wn load Ma nag e r 

Tutorials 

• Adding Entries to the Standard Context Menu 

• Adding Explo rer Bars 

• Ad ding Menu Item s 

• Adding Toolbar Buttons 

Examples 

• Web Accessories 
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Zipped HTML version of this doc 



About This Document 
Widget Oyendew 
Reference Information 
XUL Syntax 

Org^zatjon of XlE^Interfaces 
About This Document 

This document is a reference for the XML-based User Interface Language (XUL). Like the interface 
widgets that XUL describes, this reference is organized hierarchically. For example, almost all of the 
widgets inherit from the box widget, which means that they share the attributes described in that area of 
the reference. Where attributes are inherited, those attributes are italicized in the spelling for that 
widget. The menubar object and the attributes it inherits from box are a good example of this. 

A veiy small collection of attributes are general to all widgets but not inherited from generalized 
widgets or tools like <box>. These include attributes like id, with which every XUL widget can be 
specified. These attnbutes are defined in a common file. Where common attributes are implemented or 
used differently by different widgets, the attributes are described with their respective widgets Values 
for class vary quite a bit from widget to widget, for example, so class is defined separately for each 
widget that includes it. 

The following sections contain a very brief introduction to XUL. This introduction is intended merely 
to preface the XUL reference information that this document contains. 

Widget Overview 

The root element in a XUL file and the top level of the interface it defines is the <windo_w> element 
All XUL files must contain one and only one window element. The entire XUL interface is defined 
within this root element. 

Typically, a XUL interface is composed of some combination of menubars and toolbars and a content 
area. A typical XUL file might define a very simple window with the following basic (but too simple to 
be technically valid) structure: 

<window> 
<menubar> 

<menu label="File" /> 

<menu label="Edit" /> 
</menubar> 
<box> 

<browser /> 

</box> 
</window> 

Each of the children of <window> (i.e., menubar and box) may themselves contain child elements. 
XUL provides for the absolute positioning and nesting of elements. In this way the interface is built up 



http://www.mozilla.org/xpfe/xulref/intro.html 



2/13/2004 



Page? of 3 



from the basic window. 



The list of XUL widget groups are as follows; 



window 
box 

menus and menubars 
toolboxes and toolbars 
tab widg et 

<^edcbox 
titled buttons 
scroll bar 
splitter 

progressmeter 



Reference Information 

What makes the example XUL snippet in the previous section nearly useless is the lack of detail The 
box widget, for example, should be positioned and identified, the window itself should be given a title 
and various event listeners, and so on. For the most part, this sort of functionality is specified with 
attributes of the widgets in the XPToolkit. Some of the attributes, such as the box's flex attribute are 
optional, and are used for laying out the widgets in the interface; other attributes, such as the value of 
menuitems or the namespace declarations for the window element itself are required and break the 
mterface if they do not appear. This document describes all of the values and attributes that the 
XPToolkit widgets support, as well as the genealogy and structure of valid XUL documents These two 
main categories of information appear as the Attributes and Common Children for each XUL wideet 
respectively. I,a 5^> 



XUL Svntax 

S ™T X ^ L " baS ? interfaC ! l e f inition la nguage. As an application of XML, XUL adheres to the 
W3C XML .1 J) jp_ecifi_cation and follows the syntax rules defined there. The four cardinal XUL svntax 
rules are as follows: 3 

• All events and attributes must be written in lowercase 

• All strings must be double quoted 

. Every XUL widget must use close tags (either <tag></tag> or <tag/>) to be well-formed 

• All attributes must have a value 

Note that XUL is not very forgiving about syntax problems and typos. Most of the time a XUL file 
will not display at all if one or another element has been improperly marked up. Ignore these cardinal 
rules at your peril and vexation! 

Organization of XUL I nterfaces 

There are a number of additional files that work with the XUL file to create a single window 
Collectively, these files are referred to as a package, and include such things as the style sheet for the 
XUL, a DTD that contains entity declarations for localizable strings in the interface, and additional 
XUL that may overlay the basic XUL file. Menu items and other commands issued in one XUL file can 
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display other XUL files. For example, the Edit Bookmarks command invoked from the navigator xul 
fs laStfTet 6 fi" " *" ^ ^ C ° mbinati ° n ^ + * In ^ ^ 
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DevEdge Online Archive 
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DevEdoe site . 

Plug-ins Newsgroup FAQ: 

Plug-ins 

DevEdge Champions for the Plug-ins Newsgroup 

Jason^ummere software engineer and systems administrator at Medical Informatics 
Engineering in Fort Wayne, Indiana. 



(If you have additional questions about Plug-ins, visit the discussion grou p ) 
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Section 1: General 



1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 
10. 
11. 
12. 

13. 

14. 
15. 
16. 



§hp_uJ41^ alJocate memp or can I use the new operator in C++? 
If so how? — ' 

Does plu^-in use how do I find how much of Navigator stack is available? 

Is it possible to have more than one plug-ins directpry? ' 
How do someone keep track of ins tance parameter that is reouired to call NPN * functions? 
Is it possibl e to add additional items in the navigator's menu bar? 
( s it possi ble to fi nd out with in my plug r in for. which MIME type it was invoked? 

[Sit possible to know whether^ came from a server or from the local hard drive? 

How can I aguire the keyboard focus within my plug-in? 
How can I capture mou se double cjickjn .my j{ug.jn7 

Can I use th^ to search strings in my plug-in? 

Is it possible to implement drag and drop at plug-in level? 

Is. there .anyway, that I can specify a custom scheme in a web URL in order for my plug-in to take over the 
data transport by talking to its own server? 

Can I reference to files e xisting in the same remote dirprtnry a _s my HTML files? 

Can the plug-in define itself the size ignoring the HEIGHT and the WIDTH parameter? 

I want to .read string resources in my plug-in DLL but I am unable as I don't have the HINSTANCE for the 

DLL, as I don't know where DLL Main is being called? 
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17. Does Navigator jaflow resizin 

18. What is the best way to provide a plug-in with a menu? 

19 - Our plug-in supports two file types. (* bub and Xautt Ho w do I setup the File Extents entry in the te^ narr^ 
to. support this? ' 

20. Is it possible to use separate threads for my plug -in? 

21. Is it possible to make a pluo-in take over the entire client area using EMBED tao attributes? 

22. Can a 16 bit windows plug-in ru n on a 32 bit windows platform? 

23. Why it is not possible by the user to flexibly configu re wh ich MIME types are handled by which pluq-ins 
under windows, under Unix or Mac though? 

24- In Netscape Navigator 2.6. the scrol l-bar position could be controlled by other programs using Send 
message Q of Windows' API, however, after 3.0 this became im possible, 

25. Can I handle some of the HTML pages in my„plug-jn? 

26. Why does m 

27 - Can I use Nets cape's built in co de for decoding ipeo and oif files, which I can in turn use it with mv plug-in? 

28. Men J click p , get one se p a rate window for every 
(ink. Is there any__^ for multiple links? 

29. How do I set the MIME-tvpes for mv pluo-in? 

30. How can I obtain the HTTP proxy information from mv Pluqin? 

31 . How to locate the jnst^ 0 f Netscape browser? 

32. How dp I set or read_u ser identity from vyjthin .a plugjn ~ ? 

33. ^e^i How do I support multiple MIME types in a Unix p lug-in? 



1.1: Should I use NPNJWemAlloc() to allocate memory from my plug-in or can I use the new operator 
C++? If so how? 



in 



Navigator memory methods are only necessary when Netscape is meant to take the ownership of the 
memory. Any memory that Netscape will not own can be allocated as you like. So NPSavedData structures 
must be allocated using NPN_MemAlloc(). It is, however, a good idea to use NPN MemAlloc whenever 
possible. ~ 

Here's how you override new and delete: 

#ifndef _NPAPI_H_ iinclude "npapi.h" #endif class CNetscapeMemObj ect { 
public : 

void* operator new(size_t size) 
{ return NPN_MemAlloc ( size ); }; 
void operator delete ( void* theThing ) 
{ NPN_MemFree ( theThing ) ; } ; 

}; 

Advantage is that any subclass of this class will use the same new and delete operators 
(provided, of course, that you do not override these operators.) 

1.2: Does plug-in use Navigator Stack? If so, how do I find how much of Navigator stack is available? 

Yes, plug-ins do use Navigator Stack. One can use editbin tool to find out the space available in the 
navigator stack. 

1.3: Is it possible to have more than one plug-ins directory? 

Unlike in Unix or the Macintosh platform, in Windows it is not possible to have plug-ins anywhere else other 
than the plug-ins directory. There can be only one plug-ins directory always under the directory where 
netscape exe is located (e.g.. netscape_directory\program\). 

1 .4: How do someone keep track of NPP instance parameter that is required to call any NPN_* functions? 

To call NPN_* methods one has to know the instance parameter. Instance value is passed when call to 
NPP_New() is made. This can be saved as one of the data members in your plug-in data structure and use 
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when needed. 



If your plug-in is Live Connect enabled you'll use netscape _plugin_Plugin _getPeer() to obtain the pluq-in 
instance. y 

1.5: Is it possible to add additional items in the navigator's menu bar? 

You cannot modify or add a menu or a menu item to navigator's menu bar. Toolbar does not have any 
access too. You can modify them using the Administrator's Kit available from Netscape. 

1.6: Is it possible to find out within my plug-in for which MIME type it was invoked? 

When a new instance of your plug-in is created, NPP_New() is called. The MIME type information can be 
got from NPMIMEType. 

1 7: Is it possible to know whether data stream for my plug-in came from a server or from the local hard 
drive? 

You can check for first four bytes in URL parameter of NPStream when NPP NewStreamQ is called. If it is 
file, then the data stream is from local hard drive. If it is http, then data stream is come from a server over 
the network. 

1.8: How can I aquire the keyboard focus within my plug-in? 

To acquire the keyboard focus, you have to use the SetFocus method (either cwnd: : Set Focus ( ) 
or : : SetFocus (HWND hWnd) if you aren't using MFC). This enables the plug-in to handle the 
WM_Keydown Messages. 

1.9: How can I capture mouse double click in my plug-in? 

As per the current writing mouse double click messages cannot be captured because CS_DBLCLKS style 
bit is not set when the Navigator's window class is registered. There are work arounds of course but its not 
clean way. Here's one work around 

Here's the code to put in the left button up message, where clickjime is a static or global variable: 

if (click_time == 0) 

click_time = GetMessageTime ( ) ; 

else 
{ 

click_time = GetMessageTime ( ) - click_time; 
if (click_time < (long) GetDoubleClickTime { ) ) 
SendMessage (hWnd, WM_LBUTTONDBLCLK , WParam, lParam) ; 
click_time = 0; 

} 

1.10: Can I use the Navigator's 'Find' dialog to search strings in my plug-in? 

It is not possible to use any of the Navigator's Resources within your plug-in. Navigator cannot handle such 
requests without any hooks. As per the current writing no hooks are provided by the plug-in SDK. 

1.11: Is it possible to implement drag and drop at plug-in level? 

You can use the OLE drag and drop facilities as you would in any other application. 
1.12: Should I use the window passed in as a parent window or as a dialog window to use a non modal 
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Dialog in my plug-in? 

You should use the plug-in window as the parent with MFC. Make sure that you are using window- 
window, rather than window itself. window->window which is of type void* but can be cast to an 

HWND. 

1.13: Is there anyway that I can specify a custom scheme in a web URL in order for my pluq-in to take 
over the data transport by talking to its own server? 

Plug-ins cannot act as protocols at this time. The way this is usually handled is that some connection 
descriptor, transferred via http with a unique mime-type, is loaded into the plug-in. That connection 
descriptor contains the information needed to open your own sockets to handle the protocol. 

1.14: Can I reference to files existing in the other directories as my HTML files? 

Navigator 3.0 supports relative URLs in the GetURL and PostURL methods. So if the document was 
located at "http^/www.foo.com/index.html", then calling NPN_GetURL with an URL of "bar html" would get 
the document "http://www.foo. com/bar. html". Navigator 2.0 does not support relative URLs. 

1.15. Can the plug-in define itself the size ignoring the HEIGHT and the WIDTH parameter? 

No. Plug-ins have to use the size specified in the HEIGHT and WIDTH attribute. If these are not mentioned 
they are set to the default value. 

1.16: I want to read resources in my Plug-in DLL but I am unable as I don't have the HINSTANCE for the 
DLL, as I don't know where DLL Main is being called? 

To get the handle in Win32, perform the following: 

HMODULE hlnst = GetModuleHandle ( "pluginFilename . dll " ) ; 

In Win16, perform the following: 

HINSTANCE hlnst = (HINSTANCE) GetWindowLong (hwnd, GWL_H INSTANCE) ; 

1.17: Does Navigator allow resizing of my plug-in? 

Resizing of the piug-in is not supported in the plug-in API until 4.x. This may be considered in future 
implementation. 

118: What is the best way to provide a plug-in with a menu? 

If you are using Visual C++ and MFC then subclass the window that Netscape gives you into a frame 
window rather than a view window. From there you should be able to add menus, status bars, whatever. 

119: Our plug-in supports two file types. (\bub and \aut) How do I setup the File Extents entry in the 
resources to support this? 

Either of them will work. 

VALUE "FileExtents", M texjtcx\0" 

VALUE "FileOpenName", "TeX Files for IBM techexplorer ( * . tex) | IBMtechexplorer 

Files (*.tcx)\0" 

VALUE "MIMEType", "application/x-tex t appli cation/x-techexplorer \0" 
OR 

VALUE "FileExtents", "abc,def\0" 

VALUE "FileOpenName", "My Test Files ( + . abc; * . def ) \0" 

VALUE "MIMEType", "application/x-test \0 " 
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1.20: Is it possible to use separate threads for my plug-in? 

Plug-in APIs aren't reentrant, so you'll need to either only call plug-in APIs from the main thread or use 
some sort of monitor/locking scheme to prevent your threads from reentrantly calling into Navigator Plug- 
ins doesn't support multi-threading as of this writing. 

1.21 : Is it possible to make a plug-in take over the entire client area using EMBED tag attributes? 

Any tag that take HEIGHT and WIDTH support percentages. Hence by specifying HEIGHT=100% and 
WIDTH=100% in the EMBED tag you can make a plug-in take over the entire client area. 

1.22: Can a 16 bit windows plug-in run on a 32 bit windows platform? 

32-bit code runs in a flat address code and 16-bit code runs in a segmented architecture. The Navigator 
32-bit code would have to thunk down to the 16-bit code. It's possible to do all this (that's how Win 95 itself 
is implemented; all of the Window Manager and the graphics engine are 16-bit code), but it isn't worth it 
It's really easy for a plug-in developer to produce a 32-bit DLL 

1.23: Why it is NOT possible by the user to flexibly configure which MIME types are handled by which 
plug-ins under windows. This is possible under Unix or Mac though? 

There's no technical reason why this is not possible. It's not possible simply because it is not implemented. 
This may be considered as a feature for future implementation. 

1.24: In Netscape Navigator 2.0, the scroll-bar position could be controlled by other programs using 
Sendmessage() of Windows' API, however, after 3.0 this became impossible. 

There are no plans to give plug-ins direct control of the Navigator scroll bars (for full-page plug-ins, 
Navigator doesn't draw any scroll bars, so the plug-in can implement their own). We don't want to 
encourage developers to make assumptions about, or have dependencies on, the internal workings of 
Navigator. 

1.25: Can I handle some of the HTML pages in my plug-in? 

When you override the HTML MIME type, the Navigator crashes. You would have to take over all of the 
HTML processing (that includes setting up and calling other plug-ins) because once you've taken over the 
HTML mime type, there's no way to go back and tell the navigator to take over where you left off. 
One workaround would be to get a HTML file into as a new stream into your piug-in (by issuing 
NPN_GetURL() with target as NULL), parse the stream, modify the tags as necessary and post the data 
back to Navigator using appropriate calls. 

1.26: Why does my plug-in receive two NPP_SetWindow() calls? 

NPP_SetWindow() may be called by Navigator many times due to different reasons. You are not supposed 
to do anything until you gets a valid window handle. 

1 .27: Can I use Netscape's built in code for decoding jpeg and gif files, which I can in turn use it with my 
plug-in? 

This is not possible. No hooks are provided to reuse the Navigators existing code. You will have to re-write 
code for decoding these files yourself in your plug-in. 

1.28: When I click on links that use LiveAudio plug-in provided by Netscape, I get one separate window 
for every link. Is there any way to use a single LiveAudio plug-in for multiple links? 

What you are observing is the intended behavior. There is no way to use a single window for multiple links. 



http://developer.netscape.com/support/faqs/plugins/general.html 



2/13/2004 



i^age 0 oi i o 



Also since Navigator has a special built in code for LrveAudio plug-in, window open or close is not in 
developers control. 

Since all the APIs for LiveAudio plug-in is available, you can write your own GUI using Javascript and take 
necessary actions. Click here for more information. K 

1.29: How do I set the MIME-types for my plug-in? 

Windows: MIME type information and the file extents that the plug-in will handle is available in the 
resource file (\rc) created by the plug-in developer. During start up, Netscape navigator will read the 
resource file to find out what MIME type a particular plug-in module can handle 

Unix: MIME type list is returned by NPP_GetMIMEDescription(), which Netscape Navigator calls for each 
plug-in module during startup. 

1.30: How can I obtain the HTTP proxy information from my Plugin? 

In Netscape 3.x, you can use obtain the proxy information from registry It is available at 
HKEY_CURRENT_USER\\SOFTWARE\\Netscape NavigatorWProxy Information 
In Communicator, you have to use signed script and read the user preferences file to obtain the Droxv 
information. K 3 

1 .31 : How to locate the installed directory of different versions of Netscape browser? 

Here's the law of the land for where the "Install Directory" is located and what it contains 
32bit, Navigator 3.x: 

HKEY_CURRENT_USER\Software\Netscape\Netscape NavigatorWIain 
32bit, Communicator 4.x: 

H KE Y_LOCAL_M AC H I N E\Softwa re\Netsca pe\N etsca pe Navigator\4.x(en)\Main 

The Install Directory variable here will contain the full path to the Communicator directory which is the 

parent folder of the folder where netscape.exe is located. 

16bit, Navigator 3.x: 

%windir%\win.ini 

Look for the INN key in the [Netscape] section. It will contain the full path to netscape.ini 
ie.c:\netscape\netscape.ini. You will then have to parse the string info to extract the "cAnetscape" 
16bit, Communicator 4.x: 
%windir%\nscp.ini 

Look for the Install Directory= key in the [Netscape NavigatoM.x (en)] section. This key will contain the full 
path to the folder of Netscape.exe (which is different from the 32bit Install Directory variable). 

1 .32: How do I set or read user identity from within a plugin? 

With Netscape Navigator 3.x you cannot read the identity for security reasons. However in Communicator 
you can set or get the user identity using liveconnect and signed scripts or java classes. 

hcwj 1 .33: How do I support multiple MIME types in a Unix plug-in? 

In the string that your NPP_GetMIMEDescription() returns, separate multiple entries with colons, and 
separate multiple file extensions with commas. For example, "image/foo:foo:FOO 
file:image/bar:bar,bar2:BAR file". 

Back to the Question^ or to the top. 

Section 2: Installation/Loading 

1. Why doesn't Netscape load mv plug-in? 

2. Netscape Navigator can findj^ne^ js not 
enabled. ~ 
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3. How does Navigator detect and load plug-ins? 

4. How do I install a plug-in? 

5. How one would go about finding w here to put a plug-in on windows based systems? 

6. H ow do I fjn d N etscape„ PJ ug i n di recto ry? 

7. NEWiin Window support the same MIME type, which one will Netscape use? 

2.1: Why doesn't Netscape load my plug-in? 

Verify that DLL has been created with the necessary entry points. Check the .DEF file. 
Verify that Version control block has the necessary no. of file extents, MIME types & open file types. 
Verify that Block Header in Version control block has the *US English' & 'Windows Multi-lingual'. 
Name the DLL starting with characters 'NP...\ 

Move DLL into the directory \netscape_directory\program\plugins. Restart the Netscape. 

Add the MIME type & file extensions to the server's MIME type configuration file. Restart the server. 

Clear the Netscape cache to ensure that browser is not picking up the URL contents from its cache. 

If your DLL is using secondary DLLs or some other resources, ensure that your path is set up such that 
Windows can find it at load time. 

Does your system has enough memory. 

Verify that you are not loading a 16-bit DLL in the 32-bit browser. 

2.2: Netscape Navigator can find my new plug-in, but in the about:plugins, the list shows that my pluq-in 
is not enabled. a 

This problem usually happens when you have another plug-in installed with same MIME type. Try 
removing the other plug-in to see if your plug-in gets enabled. 

2.3: How does Navigator detect and load plug-ins? 

When Netscape Navigator starts up, it checks for plug-in modules in the "plugins" subdirectory If plug-in 
modules are available, Navigator looks for mime type and extension info from the version resource. 

In a similar way if you wish to obtain the plug-in info you can check the code module and look for mime 
types and extension info. Also using JavaScript one can find out if a particular plug-in is existing using the 
plug-in property of navigator. 

If you specify SRC attribute in your EMBFO tag to load a plug-in, Navigator can't create a plug-in until its 
downloaded the SRC document and determined the MIME type, which requires a slight delay. With a 
TYPE attribute Navigator knows the MIME type immediately and can load the plug-in right away. 

2.4: How do I install a plug-in? 

Plug-ins can be installed through various methods, including manual installation (in which the user copies 
the plug-in to the appropriate directory by hand), automatic installation with an installation scripts provided 
with the plug-in, and Navigator's assisted installation feature. 

2.5: How one would go about finding where to put a plug-in on windows based systems? 

For Netscape Navigator on Win95/NT, use the registry key: 

HKEY_CURRENT_USER/ Soft ware /Net scape /Net scape Navigator /Main/ >Key is 
Ins tall Directory 

For Win16: 

The path to NETSCAPE.INI can be found in WIN. INI. 
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NETSCAPE.INI contains the key INSTALLDIR . 

(HOWEVER if you install multiple copies of Netscape, the WIN. INI file is NOT updated.) 
2.6: How do I find Netscape Plugins directory? 

Plugins directory is always located under program directory. Program directory is where netscape.exe is 
present by default. Do not try to relocate netscape.exe on your machine. Navigator executable searches 
for libraries, dlls etc., in its built in directory structure. 

Ncwj 2.7 In Windows, if two plugins support the same MIME type, which one will Netscape use? 

The last one in the physical order of the directory oh disk takes precedence. To see the physical order, 
open a DOS box and use the DIR command on your Plugins directory. 

Back to the Question Summary, or to the top . 



Section 3: Plug-in API (General) 



1- Whigjnfo 

2. Is there a way of find ^ . f rom with in the pi ug : in code the n of the file currently loaded by the Browser? 

3. Sometimes NPP StreamAsFileO gives me a NULL filename? 

4. How do I use NPSavedData parameters of NPP NewO and NPP DestroyQ ? 

5. When „ca[|jn data, and so can I free the 
associate 

6. Why does Netscape Crash in NPN~WriteO when the target Parameter to NPN NewStreamO is specified 
as current, top or name of the pluo-in Window? 

7. How can I. retrieve the data .saved in N PP_Destroy ( ) in the NPP_New() method if the same URL is not 
accessed? 

8. Why are mv calls to NPN StatusO ignored? 

9. How do I get the brow^ plug-in? 

10. Why dg^ browser vera^ 

11. N^ Why do I get "unresolved symbol" errors when I try to compile a windowless pluo-in? 



3.1: What info can be obtained from argc, argv and argn parameters in NPP_New()? 

The parameters argc, argn and argv pass a list of name-value pairs to the plug-in for the HTML attributes 
associated with this instance. 

For example, the following EMBED tag has standard attributes SRC, HEIGHT, and WIDTH, and non 
standard attribute LOOP: 

< EMBED SRO "movie.avi" HEIGHT=100 WIDTH=100 LOO P= TRUE > 

With this EMBED tag, Netscape would pass the following values to the plug-in instance: 

argc = 4 

argn = { "SRC", "HEIGHT", "WIDTH", "LOOP" } 
argv = { "movie.avi", "100", "100", "TRUE" } 

3.2: Is there a way of finding, from within plug-in code the name of the file currently loaded by the 
Browser? 

Using LiveConnect (for navigator 3.x and above) you can access the Location object from which you can 
get the URL of the currently loaded page. This doesn't function very well in Navigator 3.x due to the famous 
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MAYSCRIPT error. 

-Call NPN_GetURL(instance, "javascripfcdocument.location;", NULL); 

This will result in a new stream being sent to your plug-in. The first chunk of data (from the first call to 
NPP_Write) will contain a bunch of HTML formatting that you can ignore. The second chunk will contain a 
zero-terminated string with the URL of the document which contains your plug-in. 

3.3: Sometimes NPP_StreamAsFile() gives me a NULL filename? 

When the size of a file exceeds the size of Navigator's cache, the file will not be saved and the filename will 
be NULL. The decision was made to not violate the user's cache setting, even though it causes trouble for 
plug-in developers. 

When you use NP_ASFILE stream type, the file is saved in the Navigator cache. For security reasons data 
retrieved via SSL isn't cached by default, so NULL gets passed to NPP_StreamAsFile() to indicate that the 
file couldn't be cached. 

You can change this setting in the Cache page of the Network preferences window. 

3.4: How do I use NPSavedData parameters of NPP_New() and NPP_Destroy()? 

When you leave the current page in which the plug-in is loaded, Navigator will destroy the plug-in instance 
If at some point of time when you come back to the same page, plug-in gets reloaded. If loading of the 
plug-in is going to be time consuming then it is advisable to use the NPSavedData argument of NPP New 
() and NPP_Destroy(). If you pass your data pointer to the Navigator in NPP_Destroy(), in the next call to 
NPPJMew() when plug-in gets reloaded, the saved data will be returned to plug-in via the NPSavedData 
parameter. 

3.5: When calling NPN_Write(), will Navigator then make a local copy of the data, and so can I free the 
associated memory buffer after calling NPN_Destroy()? 

Yes, Navigator will make a copy of the data as necessary. You can (and should) free the buffer when 
you're done with it. 

3.6: Why does Netscape Crash in NPN_Write() when the target Parameter to NPN_NewStrearn() is 
specified as .current, _top or name of the plug-in Window? 

The problem is that if you write into the current Window, you will be overwriting your plug-in and when the 
Write function returns, your plug-in has been unloaded. The best thing to do is to have a frame which 
* contains your plug-in and another frame into which you can write. 

3.7: How can I retrieve the data saved in NPP_Destroy() in the NPP_New() if the same URL is not 
accessed? 

You cannot retrieve the saved data in NPP_New() if the URL accessed is not the same. Actually the Nav. 
unloads the plugin DLL after handling each request. If you have multiple instances of your plug-in, it is 
possible to maintain the plug-in state. But with a single instance it is not possible. 

3.8: Why are my calls to NPN_Status() ignored? 

If you wish status message to persist for your plug-in, you should set up an event handler for EnterNotify, 
and have it reissue that last NPN_Status() call your plug-in made. That way pointing to your plug-in screen 
area will refresh the message. 

Status messages for Hidden plug-ins will be lost almost immediately. 
3.9: How do I get the browser name and version within my plug-in? 
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Plug-in API provides a function call NPN_UserAgent() which would returns a string that will contain 
information on agent software name, version, and operating system. You will have to parse the string and 
extract the required information. 

3.10: Why doesn't NPN_Version() give me browser version number? 

NPN_Version() will not give browser's version information, instead it gives plug-in version information. Its 
recommended that plug-in should check, possibly during initialization, to make sure that the version of the 
plug-in API it is using is compatible with the version Navigator is using. Changes in Major version number 
probably indicates incompatibility. 

To find browser information like version, name and operating system, use NPN_UserAgent(). 
*EWi 3.1 1: Why do I get "unresolved symbol" errors when I try to compile a windowless plug-in? 

The interface file npwin.cpp has not been updated to include all the functions required by windowless plug- 
ins. One workaround is to manually edit npwin.cpp and write an interface function named NPN_SetValue() 
that calls g_pNavigatorFuncs->setvalue(), and modify a line in NPJ3etEntryPoints() to read "pFuncs- 
>event=NPP_HandleEvent;". 

Back to the Questiori^mma.[y J or to the top. 



Section 4: Streams 

1. How do I send a mail from my plug-in? 

2. H pw to get the plug -j n to se n d data back to th e server? 

3. How do ^ call? 

4. How do I use NPN PostURLO to post large buffers if I do not have pointer to the complete buffer? 

5. URLs requested with NP N GetURLO aren't cached. 

6. How do I passjDontext information from my NPN_GetURLNotify() to first call of NPP_NewStream() when I 
issue multip le NPNGetURLNotifyQ? 

7. What window parameter should I pass when using NPN GetURLQ? 

8. neui What is the notify Data element of struct : JNPStream. used for? 



4.1: How do I send a mail from my plug-in? 

To post a mail from plug-in, you can use NPN_PostURL() with the URL parameter as 
"mailto:somebody@somewhere.com" and NULL target window parameter. Cc, BCc and Subject are not 
implemented in 2.x and 3.x. Hence H mailto:somebody@somewhere.com? 
&cc=myself@foo.com&Subject=Tesr will cause an error. 

Similarly, you can invoke the mail utility using NPN_GetURL() with the URL parameter as 
M mailto:somebody@somewhere.com?&cc=myself@foo.com&Subject=Test m and NULL target window 
parameter. This will bring up the mail utility with respective fields filled up. If the URL parameter is just 
"mailto:", then mail utility is invoked with all fields empty. Note Cc and BCc can be used here. 

There is no way to set the body or the attachments through URL. 

4.2: How to get the plug-in to send data back to the server? 

You can use NPN_PostURL() to send data back to the server. 

The response can be handled in several ways by specifying different target parameters 

-If you specify NULL, the server response is sent back to the plug-in. You can get the data and save it in a 
file or use it in your program. 
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-If you specify ".current" or "_self or Mop", the response data is written to the same plug-in window and 
the plug-in is unloaded. 

-If you specify ".new" or "_blank" ( the response data is written to a new browser window. 
You can also write the response data to a frame by specifying the frame name as the target parameter. 
4.3: How do I abort the stream data after making an NPN_GetURL() call ? 

After the stream has started, if you wish to abort the stream, then let NPP_Write() return a negative value 
This will cause the navigator to abort the stream. 

4.4: How do I use NPN_PostURL() to post large buffers if I do not have pointer to the complete buffer? 

If you are going to receive large buffers within your plug-in, you can create a temporary file and dump all 
the contents into it. Once you are done with your data you can use NPN_PostURL() with file pointer as the 
URL and the file parameter as TRUE. 

4.5: URLs requested with NPN_GetURL() aren't cached? 

There's a bug in some versions of Navigator (3.0 has the bug, not sure about 2.0) whereby URLs 
requested with NPN_GetURL() aren't cached (and aren't loaded from the cache if already cached). There 
are some workarounds: basically you need some other way to request the URL besides normal 
NPN_GetURL(). One thing recommended is doing an NPN_GetURL() of a "javascript " URL to execute 
some Javascript to load the URL into the desired target. Here's an example 

NPN_GetURL 

{ instance, " j avascript : window . location . href = * http : //home . netscape . com/ ' " , NULL) ; 

4.6: How do I pass context information from my NPN_GetURLNotify() to first call of NPP NewStreamO 
when I issue multiple NPN_GetURLNotify()? " 

You can use the notifyData member of your NPStream structure which gets passed in your 
NPP_NewStream(). This notifyData is same as the notifyData passed as part of your NPN_GetURLNotify 

0* 



4.7: What window parameter should I pass when using NPN_GetURL()? 

-If you want the new stream to be handed to your plug in no matter what the MIME type may be, your 
window parameter should be NULL. 

-If you want to load the new stream in the same window your plug-in occupies, you should use the magic 
window names "_current n or "_self '. 

-If you want to load the new stream to a frame or another browser window, your window parameter should 
be a valid target window name. 

-If you want to load the new stream to a new browser window "_new M is the target parameter. 

For more information on window naming see Frames Documentation. With the current plug-in interface you 
will have to hard code the frame name in your plug-in. 

new 4.8: What is the notifyData element of struct NPStream used for? 

notifyData will reflect the string that was part of notifyData parameter in NPN_GetURLNotify() or 
NPN_PostURLNotify(), when NPP_NewStream() gets called due to NPN_GetURLNotify() or 
NPN_PostURLNotify() with target parameter as NULL 
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Back to the Question Summary, or to the top. 



Section 5: Printing 

1- Is it possible for mv plug-in routine for embedded printing to access fields set in the print dialog? 

2. Why doesn't NPP Printf) function properly in mv plug-in? 

3. What type is platf prm pri nt in Windows of the _NPEmbedPrint Structure. Also what is the type of void* 
Window w hich is a member of N P Window? 

4. While in NPP PrintO. I want to perform additional network IP. 



5.1: Is it possible for my plug-in routine for embedded printing to access fields set in the print dialog? 

This is not possible. There is no way for plug-in getting hooked to the Navigator controls. This may be 
considered as an feature for the future release. 

5.2: Why doesn't NPP_Print() function properly in my plug-in? 

Prior to Navigator 3.0 NPP_Print() will not function properly. If the plug-in is in Full page mode, NPP_Print() 
function is called with printinfo as NULL. In the case of Embedded plug-in, the mode variable will not be 
properly initialised. 

5.3: What type is platformprint in Windows of the _NPEmbedPrint Structure. Also what is the type of void* 
Window which is a member of NPWindow? 

On Windows platformprint is a structure(defined in npapi.h) containing the printer name, port, etc. The type 
of void* window denotes the 'window* field pertaining to the handle of the specific platform into which the 
plug-in in stancexan-draw. Here, platformPrint is the handle to the printing device context. 

5.4: While in NPP_Print(), I want to perform additional network IO. 



Unfortunately there's no easy solution for you. The plug-in API network routines are all asynchronous, and 
the I/O occurs on the same thread as the plug-in, so there's no way (currently) to just block until you get the 
data. Better multithreading is a long-term future goal for the plug-in API. 

Back to the Question Summary s or to the top. 



Section 6: Testing 

1- How do I test mv pluo-in? 

2 . I wish to have two frames 1 and 2. Frame one will have a link when cli cked will have to load the plu g-in in 
frame 2 r How.doJ do t his ? 

3. Is there any yyayjo use or support the ''X-ALT SRC" tag from within an "EMBED" string? The idea is, if 
Netscape can't find the plug-in for the "SRC=" . it would try to handle the "X-ALT SRC=". 

4. new* H ow to debug my plug-in? 



6.1: How do I test my plug-in? 

Once you have completed the implementation of your plug-in, you should test it by creating an HTML 
document To invoke and display the plug-in, this HTML document must contain the EMBED tag. The 
EMBED tag must include attributes that specify the plug-in to be called, the width and height of the window 
in which the plug-in is displayed. In addition, optional attributes can be used. Here's how : 
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< EMBED SRO"movie.avi" HEIGHT=100 WIDTH=100 LOOP=TRUE > 

6.2: 1 wish to have two frames 1 and 2. Frame one will have a link when clicked will have to load the plug- 
in in frame 2. How do I do this? 

This can be done in two ways 

o In the onClick handler you can dynamically write an EMBED tag to load a plug-in. 

o When the link is clicked, you can load a html page into the second frame which will have an EMBED 
tag to load the plug-in. 

6.3: Is there any way to use or support the "X-ALT SRC" tag from within an "EMBED" string? The idea is, 
if Netscape can't find the plug-in for the "SRC=", it would try to handle the "X-ALT SRC=". 

This feature is currently not supported. Also to load multiple plug-ins you cannot have multiple SRC 
attributes in an EMBED tag. You can load multiple plug-ins by having as many EMBED statements. 

newj6.4: How to debug my plug-in? 

With Netscape Navigator printf() is not very helpful, because GUI programs ignores any printing to stdout 
or stderr. On Unix versions of Navigator, Navigator displays output printed to stderr in a dialog. 

You can also use Source Debuggers to debug your plug-in. 

Debugging Windows Plug-ins Using Visual C++ 
o Set breakpoint(s) 
o Select Build/Debug/Go menu 

o A dialog will pop up asking you to type in the executable. Enter the complete path of your Netscape 
Navigator and click OK. 

o A dialog will appear to warn you that Netscape Navigator has no debugging information associated 
with it. Click Yes to continue. 

o Browse a web page that causes your plug-in to load, 
o Netscape Navigator stops at breakpoint(s) set by you. 
o Step through to debug. 
Debugging Plug-ins on Unix Using dbx 

Refer to Netscape Developer's Guide to Plug-ins, Douglas A. Young, Prentice Hall PTR, 1997. 
Back to the Question Summary, or to the top. 



Section 7: LiveConnect-General 

1 . Why doesn't mv LiveConnect enabled pluo-in work properly? 

2. When I cM.n^ to obtain the native NPP object, the function returns a 
NULL? 

3. How do I export native function calls within a plua-in? 

4. How do I get a reference to the instance of the plug-in's java class? 

5. Where can 1 find Netscape's javah ^u 

6. When I use found: aborting? What's going wrong? 

7. How to return an array of Strings from plua-in to java? 

8. new> In Windows, Netscape crashes when I call getPeerQ. 



7.1: Why doesn't my LiveConnect enabled plug-in work properly? 

• -Ensure that your plug-in peer class is in your plug-ins directory along with the plug-in dll. 
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• -Ensure you have called use_ methods in NPP_GetJavaClass() to ensure the instance of your plug-in 
class gets created. Also remember to call its unuse_ method to destroy its instance when done. 

• -Define IMPLEMENT_myClass before including myClass.h to state that you are implementing the native 
methods of this plug-in and consequently need to access it's protected and private memebers. 

7.2: When I call netscape_plugin_Plugin_getPeer() to obtain the native NPP object, the function returns a 
NULL? 

If you forget to call use_netscape_plugin_Plugin(env) in your NPPj3etJavaClass() you will get a null when 
you use getPeer. 

Call all the "use_" routines in your NPP_GetJavaClass() routine, returning the one that is the class of your 
plug-in. 

Also remember to call the corresponding "unuse_" routine so that your classes can be unloaded when the 
plug-in shuts down. 

7.3; How do I export native function calls within a plug-in? 

When you are compiling the jri stub file(.c file) that is to be included in your project IMPLEMENT^ 
your_class_name > must be defined. This makes possible for your native methods to access the private & 
protected fields of that specified class. You can either set it globally thru* your compiler arguments, or 
instead of directly linking the stub file, you would link in a file called javastubs.c that looks something like 
this: 

tdefine IMPLEMENT_<your_class_name> 
tinclude "<your_class_name> . c" 
#include "netscape_plugin_Plugin . c" 

7.4: How do I get a reference to the instance of the plug-in's java class? 

Actually plug ins appear as instances of the class netscape.plugin.Plugin to java Programs. Netscape calls 
plug-in's NPPJ3etJavaClass() method in which you have to declare all the native methods with the 
variable "use". Now you can use NPN_GetJavaPeer() method which gives the specific instance of the 
plug-in's Java object. 

7.5: Where can I find Netscape's javah utility? 

Netscape's javah utility for windows is located under PluginSDK/bin/win32. Under unix, it is located in bin 
directory under your Plugin's SDK directory. This utility is not available for MAC yet. 

Remember to use Netscape's j a vah utility to create your header and stubs files. If you get an "illegal 
argument" error when using javah with - jri option, it means you are using Sun's javah. 

7.6: When I use javah, I get java. lang. Object not found: aborting? What's going wrong? 

Your classpath is not set properly. Ensure that your classpath points to java_30 library present in your 
classes directory under your installed plugin directory. 

7.7: How to return an array of Strings from plug-in to java? 

Here's a code snippet that you'll write in your plug-in code, to pass an array of strings to your plug-in peer 
class. 

jref array = JRI_NewObj ect Array (env, 1, class_j ava_lang_String (env) , NULL); 
char* msg = "String array from plugin"; 

str = JRIJNIewStringUTF (env, msg, strlen (msg ) ) ; /*where str is a jref 
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variable*/ 

JRI_SetObjectArrayElement (env, array, 0, str) ; 

new* 7.8: In Windows, Netscape crashes when I call getPeer(). 

Instead of self->getPeer(env) t use netscape_plugin_Plugin_getPeer(env, reinterpret_cast(self)). 
Back to the Question Summary, or to the tOQ. 



Section 8.0: LiveConnect-JavaScript 

1 . In mv plug-in how can I get the server IP address whe n the piug-in is launched? 

2. Can I start using the newly installed plug-in without restarting the browser? 

3. How do I get the f orm data from an HTML page to a plug-in? 

4. I have a plug-in which generates a new browser window using NPN NewStreamH. Is it possible to destroy 
the parent window? 

5. On ce my plug-in finishes its d isp lay . ca n I. a uto matj ca I |y retu m to the prey io us page? 

8.1: In my plug-in how can I get the server IP address when the plug-in is lunched? 

If your plug-in is liveconnect enabled you can use JavaScript to find the host name. You can obtain the 
Location object of Navigator. Location object will have the protocol, host, port number if any, the source 
directory and the file name that is currently displayed. 

You could also use javascript: protocol in NPN_GetURL() to obtain the same. 

8.2: Can I start using the newly installed plug-in without restarting the browser? 

With Navigator 3.0 and above you CAN start using a newly-installed plug-in without restarting the 
Navigator, by calling the JavaScript method navigator.plugins.refresh(). This method will make Navigator 
"notice" any new plug-ins in the plug-ins directory. If you call navigator.plugins.refresh(TRUE), Navigator 
will reload pages containing plug-ins so the user will actually see the new plug-in (if applicable). There are 
also JavaScript properties that let you see which plug-ins are currently installed (the navigator.plugins[] 
array). 

8.3: How do I get the data from an HTML Page to a plug-in? 

You can do this using liveconnect. On an event you can call a native method and pass all the HTML form 
data to the native code as name value pairs. You can parse this string in your native function and extract 
the values. 

It is also possible to Submit form to a plug-in by specifying the ACTION attribute which can be a relevant 
plug-in file (that is usually specified as part of the SRC attribute in the EMBED tag). You will receive form 
data when call to NPP_NewStream() is made. 

8.4: 1 have a plug-in which generates a new browser window using NPN_NewStream(). Is it possible for 
me to destroy the parent window? 

In your new window you'll refer to the parent using refferer property of JavaScript. Parent window (the 
refferer) could have a JavaScript function which would close the window. 

8.5: Once my plug-in finishes its display can I automatically return to the previous page? 

Once you know the display part is complete, you can use javascript's history object in different ways to 
return back to the previous page. 



http://developer.netscape.com/support/faqs/plugins/general.html 



2/13/2004 



rage 10 01 jo 



4 

Back to the Question Summary, or to the top. 
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Section 10: Useful Links 

• Pluain Guide 

• Tutorial on Client Plugins 

• Java To JavaScrip t Com munication 

• Java RunTime Int erfa ce 

• LiveAudio Tutorial 

• Netscape' s Plug-In Deve lopment Newsgroup 
Back to the tog. 

For the latest technical information on DevEdge Archive products, go to: http://develoDer.netsca pe.com 

For more Internet development resources, try Netscape TechSearch . 

Copyright © 1999 NeJsraj)_ejSpm^^ 
This site powered by: Netscape Enterprise Server and Netscape Compass Server 
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Plug-in Guide 




This guide tells you how to develop plug-ins that extend Netscape Communicator with a wide ranee of 
interactive and multimedia capabilities. g 



January 1998 -- Communicator 4. 0 




What's New? 



The Plug-in Guide has been updated and expanded for Communicator 4.0. This page is a 
quick reference to new Plug-in API features and document changes. 



About Th is Guide 



The Plug-in Guide is your introduction to using Netscape's Plug-in Application 
Programming Interface (API) to develop plug-ins for Communicator 4.0. 

Who Should Read This Guide? 
What's in TO 
Conyentions Us 

The Plug-in Software Develop ment Kit 
Where to F ind Develop er Information 



Chapter 1 Plug-in Basics 



This chapter provides basic information you'll need as you develop C/C++ p l U g-i 

How You Can Use Plu g-ins 
When to Use Plug-ins 
Plug-ins and LiyeConnect 

PljJg-j„ns_andJM 
How Plug-ins Work 

Understanding the Runtime Model 
How Commu nicator F inds Plug-ins 

Overview of Plug-in Structure 
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Understanding AeJP^-in.API 
Plug -ins and Platform Indep endenrp 
Windowed arid WindoMess . PI ug- ins 
Using HTML to Display. Plug-ins 
Plug- in Display Modes 
HTML Tags for Plug-in Display- 
Chapter 2 Development Overview 



This chapter is an introduction to the issues and processes that you will need to know about 
as you write plug-ins. It outlines the steps in writing and implementing a plug-in code 
module for Communicator. 



Writing Plug -ins 

Registering Plug -ins 

Drawing Plug -ins 

Handli ng Memory 

Sending and Receiving Streams 

Workin g with URLs 

Getting, Version a nd UI I nformation 

Displaying Messages on the Status Line 

Communicating with Java 

Building Plug-ins 

Building a Mac OS Plug -in 
In sta lling Plug-ins 

Starting t o Use the Plug-in 
JAR Installation Manager 

Chapter 3 Init 



This chapter describes the methods that provide the basic processes of initialization, 
instance creation and destruction, and shutdown. 



Initialization 
I nstance Creation 
Instance Destryc tion 
Shutdown 
Initialize.. 

Chapter 4 Drawing and Event Handling 

This chapter tells how to determine whether a plug-in is windowed or windowless, how to 
draw and redraw plug-ins, and how to handle plug-in events. 

The NPWindow Stnjcture 
Drawing Plug-ins 

Printing the Plug -in 

Setti ng the Window 

Getting InfonnMipn 
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Window ed P lug-ins 

Event Handling for Windowed Plug -ins 
Windowless Plug-ins 

Specifying That a Plu g-in Is WjnHnwlpQs 

Invalidating the Drawing Area 

Forcing a Paint Messag e 

Making a PlugiirLQpague 

Making a Plug-in Transp arent 

Creating Pop-up Menus and Dialog Boxes 

Event H andling for Windowless Pinning 

Chapters Streams 

This chapter describes using Plug-in API functions to receive and send streams. 
Receiving a Stream 

Idiingihej^g^ 

Telling the Plug -in W hen a Stream Is Deleted 
Finding Out How Muc h Data the Pl ug-in Can Accept 
Writing the Stre am to the Pln£-in 
Sending the Strea m in Random-Access Mode 
Sending the Stream in File Mode 
Sen ding a St ream 

Creating a Strea m 
Pushing Data into the Stream 
Deleting the Stre am 
Ex^pleofL^e^ 

Chapter 6 URLs 

This chapter describes retrieving URLs and displaying them on specified target pages 
posting data to an HTTP server, uploading files to an FTP server, and sending mail 

Getting URLs 

Getting the URL and Displaying the Pag e 
Posting URLs 

Posting Data to an HTTP Server 
Uploading Files to an FTP Server 
Se nding Mail 

Chapter 7 Memory 

This chapter describes the Plug-in API functions that allocate and free memory as needed 
by the plug-in. 

All oc at ing and Freeing Mem ory 
FJ u shing Memory. (Mac OS only) 

Chapter 8 Version, ill, and Status Information 
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This chapter describes the factions that allow a plug-in to display a message on the status 
line, get agent information, and check on the current version of the Plue-in API and 
Communicator. 



Displaying a Status Line Messag e 
Getting Agent Information 
Getting the J^urrenLYersijon 
Finding Out if a Feature Exists 
Reloading a Plug -in 



Chapter 9 Plug-in A PIRderence 



To help you familiarize yourself with the Plug-in API as quickly as possible, this reference 
is organized into sections by task and parallels the organization of Chapters 3 through 8. 

Functions 

API Organi zation: Net scape and Plug-in Methods 

Plug-in Method Summary 

Netscape Method Summary 
Plugrin APIJMeth^ Subgroups 

Plug-in Methods: Func tional Subgroups 

Netscape Methods: Functional Subg roups 
Referenced 

Quick Reference t o Functi onaj fironpg 

Initializati on and Destruction Methods 

Drawing .Methods 

Stream Method s 

URL Methods " 

Memory Methods 

Utijity_Methods 

Methods for Communicating with Java 
Structures 

Constants an d D efinitions 
Defin^ 
Error Codes 
Result Codes 
Plug-in Ver sion Cons tants 
Version Feature Constants 



Index 



Download Plug-in SDK 



[log] 
[Next] [Index] 
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Copyright © 1997 Netscape Communi cations Corporation 
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Chapter 1 

Plug-in Basics 



A plug-in is a separate code module that behaves as though it is part of the Netscape Communicator 
browser. You can use the Plug-in API to create plug-ins that extend Communicator with a wide range of 
interactive and multimedia capabilities, and that handle one or more data (MIME) types. You can even 
use the Plug-in API to create plug-ins that work in browsers other than the Navigator component of 
Communicator. 



If you are working in a Navigator 3.0 context, you can still use the Plug-in SDK, version 4.0, because it 
includes all 3.0 functionality. Simply do not implement any 4.0 additions in your plug-in. AU4.0 
additions are clearly marked in this guide. 



The Plug-in API was designed with these goals in mind: 



• extend the capabilities of Communicator by providing inline viewers for types of data not 
supported by Communicator itself. 

• provide an API that is as simple and concise as possible, making it relatively easy to leverage 
existing native code libraries or convert existing applications to take advantage of the web. 

Plug-ins can use the Netscape Java Runtime Interface (JRI) to access Java. Communication with Java, 
and through Java, with JavaScript, takes place through a LiveConnect connection. For details, see 

LiveCo nnecting Plug-ins wit}: Jay o . 

Plug-ins are part of Netscape ONE, the Open Network Environment, an application environment based 
on open Internet standards. Plug-ins allow you to bring existing code bases or operating system-specific 
code into the Netscape ONE environment, build on legacy code, and adapt existing applications for the 
web. For an introduction to Netscape ONE, see the Netscape ONE Overv ipw on DevEdge. 

This chapter provides basic information you'll need as you develop C/C++ plug-ins. 

• How You Can Use Plug-ins 



• When to Use Plug-ins 



• Plug-ins and LiveConnect 



• Plug-ins and Helper. Applications 
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Underst^iding the Runtime Model 
How „Communic^or Finds 
How Plug-ins Work 



Overview of Plug-in Structure 



Windowed and Windowless Plug-ins 



Using H TML to Displ ay PI ug- ins 



How You Can Use Plug-ins 

* 

Plug-ins offer a rich variety of features that can increase the flexibility of Netscape Communicator. 
Plug-ins like these are now available: 

• multimedia Viewers such as Live3D, Macromedia Shockwave, and Adobe Acrobat 

• utilities that provide object embedding and compression/decompression services 

• applications that range from personal information managers to games 

The range of possibilities for using plug-in technology seems boundless, as shown by the growing the 
growing numbers of independent software vendors who are creating new and innovative plug-ins. To 
see what many other developers are doing, take a look at the Development page of the Netscape ONE 
directory. On this page, select Applications and Tools, and then search for Client Plug-ins. 

With the riug-in API, you can create dynamically loaded plug-ins that can: 

• register one or more MIME types 

• draw into a part of a Communicator window 

• receive keyboard and mouse events 

• obtain data from the network using URLs 

• post data to URLs 

• add hyperlinks or hotspots to link to new URLs 

• draw into sections on an HTML page 

You can see which plug-ins are already installed on your system by consulting the Installed Plug-ins 
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page. Go to the Help menu, and click Help and then About Plug-ins. The Installed Plug-ins page lists 
each installed plug-in along with its MIME type or types, description, extensions, and the current state 
(enabled or disabled) of the plug-in for each MIME type assigned to it. 



[lop] 



When to Use Plug-ins 

Plug-ins offer solutions to development needs like these: 

• tying existing C++ code into the Netscape ONE platform 

• writing performance-sensitive code 

• taking advantage of specific operating system capabilities 

• integrating native or legacy code bases into Internet/intranet applications 

• using native methods to export low-level functionality that Java does not provide 

Because plug-ins are platform-specific, you must port them to every operating system and processor 
platform upon which you want to deploy your plug-in. Plug-ins are supported in both Netscape clients 
and servers. 

Hep] 



Plug-ins and LiveConnect 

Starting with Navigator 3.0, Netscape's LiveConnect offered a way for developers to take advantage of 
Java and JavaScript for ways to interact with the web page, for example, through plug-in controls or user 
interfaces. One of the sample plug-ins of the Plug-in SDK (NPAvi, which displays AVI movies) can be 
controlled with JavaScript using LiveConnect. 

Although plug-ins and Java can talk to each other, and Java and JavaScript can talk to each other, plug- 
ins and JavaScript do not communicate directly. LiveConnect provides the interface for communication 
between plug-ins, Java, and JavaScript. 



Plug-in 


». 


Java 





JavaScript 







LiveConnect environment 



To write plug-ins that use LiveConnect, start by writing the C code for your plug-in. Implement the 
Plug-in API methods that allow the plug-in to interact with the Java object model. For more information, 
see "Communicating with Then, go on to Netscape's official LiveConnect guide, LiveConnecting ' 
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Plug-ins with Java . 

To get a good picture of the way that the Plug-in API and LiveConnect fit together in a plug-in. read the 
View Source article, -Netscape Client Plug-Ins." This article describes a plug-in created with Microsoft 
Visual C++. 

For information about the capabilities of JavaScript, see the JavaScript Reference. 
[Top] 



Plug-ins and Helper Applications 



Before Netscape first presented plug-ins in Navigator 2.0, in the first quarter of 1996, users could extend 
the Navigator with helper applications. A helper application is a separate, free-standing application that 
can be started from the Navigator browser. 

Like a plug-in, the browser starts a helper application when the browser encounters a MIME type that is 
mapped to it. Unlike a plug-in, a helper application runs separately from the browser in its own 
application space and does not interact with the browser or the web. 

When Navigator encounters a MIME type, it always searches for a registered plug-in first If there are 
no matches for the MIME type, it looks for a helper application. 

Plug-ins and helper applications fill different application needs. For more information about helper 
applications, refer to NetHelp, Communicator's online help. 



How Plug-ins Work 

The life cycle of a plug-in, unlike that of an application, is completely controlled by the web page that 
calls it. This page gives you an overview of the way that plug-ins operate in Communicator. 

When Communicator starts, it checks for plug-in modules in the plugins directory (Windows) or 
Plug-ins folder (Mac OS) in the same folder or directory as the Communicator application. On Unix, 
Communicator checks the path set in the environment variable npx_plugin_path. For more 
information, see "How Communicator Finds Plug-ins." 

When the user opens a page that contains embedded data of a media type that invokes a plug-in 
Communicator responds with the following sequence of actions: 

• check for a plug-in with a matching MIME type 

• load the plug-in code into memory 
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• initialize the plug-in 

• create a new instance of the plug-in 

Communicator can load multiple instances of the same plug-in on a single page, or in several open 
windows at the same time. 

When the user leaves the page or closes the window, the plug-in instance is deleted. When the last 
instance of a plug-in is deleted, the plug-in code is unloaded from memory. A plug-in consumes no 
resources other than disk space when it is not loaded. The next section, "Understanding the Runtime 
Model," describes these stages in more detail. 



Understanding the Runtime Model 

Plug-ins are dynamic code modules that are associated with one or more MIME types. When Netscape 
Communicator starts, it enumerates the available plug-ins (this step varies according to platform) reads 
resources from each plug-in file to determine the MIME types for that plug-in. and registers each'nlue-i 
library for its MIME types. 



The following stages outline the life of a plug-in from loading to deletion: 

• When Communicator encounters data of a MIME type registered for a plug-in (either embedded 
m an HTML page or in a separate file), it dynamically loads the plug-in code into memory, if it 
hasn't been loaded already, and creates a new instance of the plug-in. 

Communicator calls the plug-in API function Npp_initiaiize when the plug-in code is first 
loaded. 



Communicator calls the plug-in API function NPP_New when the instance is created. Multiple 
instances of the same plug-in can exist (a) if there are multiple embedded objects on a single page, 
or (b) if several Communicator windows are open and each displays the same data type. 

A plug-in instance is deleted when a user leaves the instance's page or closes its window; 
Communicator calls the function NPP_Destroy to inform the plug-in that the instance is being 
deleted. 



• When the last instance of a plug-in is deleted, the plug-in code is unloaded from memory. 
Communicator calls the function NPP_shutdown. Plug-ins consume no resources (other than disk 
space) when not loaded. 

For information about using these methods, see Chapter 3, "Initialization and Destruction." For a 
reference entry that describes each function, see "Initia lization and Destruction Methods " in the API 
reference. 
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NOTE: Plug-in API calls and callbacks use the main Navigator thread. In general if vou 
want a plug-in to generate additional threads to handle processing at any stage in its ' 
lifespan, you should be careful to isolate these from Plug-in API calls. § 

[Top] [U nderstanding the Runtime Model] 



How Communicator Finds Plug-ins 

When Communicator starts up, it checks for plug-in modules in the plug-ins directory for the platform: 

. MS" Windows: plugins subdirectory, in the same directory as the Communicator application. 

. Mac OS: Plug-ins folder. A Mac OS plug-in can reside in a different directory if you install a 
Macintosh alias that links to the plug-in in the Plug-ins folder. 

• Unix: usr/local/lib/netscape/plugins or SHOME/ . netscape/plugins. If you want to use a 

different directory, set the npx_plugin_path environment variable to its filepath, for example 
SHOME/yourpiugins: /usr/iocai/iib/netscape/piugins. Communicator searches any ' 
directory that this variable specifies. The local user location, if it exists, overrides the network 
location. 

On all platforms, the plug-ins subdirectory or folder must be in the same directory as the Communicator 
application. Users can install plug-ins in this directory manually, by using either an installation program 
or Communicator's JAR Manager facility. For more information, see " Installing Plnp-ins " 

To find out which plug-ins are currently installed, choose About Plug-ins from the Help menu (MS 
Windows and Unix) or "?" (Help) menu (Mac OS). Communicator displavs a page listing all installed 
plug-ins and the MIME types they handle, as well as optional descriptive information supplied by the 
plug-in. 

On Windows, installed plug-ins are automatically configured to handle the MIME types that they 
support. If multiple plug-ins handle the same MIME type, the last plug-in loaded handles the MIME 
type. For information about the way MIME type is assigned, see " Registerin g Plug-ins " 

On Mac OS and Unix, starting with Navigator 3.0, users can configure which plug-ins or helper 
applications handle which MIME types by using the Helpers tab of the General Preferences window 
The Helpers tab displays a list of all handled MIME types and specifies whether the type is simply saved 
to disk or is handled by Communicator, a plug-in, or a helper application. The user can select any MIME 
type in the list and click the Edit button to change the way the MIME type is handled. For instance the 
user can select, from a pop-up menu of all plug-ins that support that type, a different plug-in to handle it. 

[Top] [How Communicator Finds Plug-ins] 



Overview of Plug-in Structure 
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This section is an overview of basic information you will need as you develop plug-ins. 

• Understanding toe Plug-in API 

• Plug-ins and Platform Indep endent 



Understanding the Plug-in API 

The Plug-in Application Programming Interface (API) is made up of two groups of functions and a set 
01 snared data structures. 

. Plug-in methods are functions that you implement in the plug-in; Communicator calls these 
functions. The names of all plug-in functions begin with npp_, for example, NPP New. 

. Netscape methods are functions implemented by Communicator; the plug-in calls these functions 
The names of all Netscape functions begin with npn_, for example, NPN_write. 

• Data structures are plug-in-specific types defined for use in the Plug-in API. The names of 
structures begin with np, for example, NPWindow. 

For a listing of methods by API group, see "API. Organization: Netscape„and. Plug-in Methods." 

In general, the operation of all API functions is the same on all platforms. Where this varies the 
reference entry for the function in the reference section describes the difference. 

[lop] [ Overview of Plug-in Structure ] 



Syntax and Usage 

A plug-in is a native code library whose source conforms to standard C syntax. All plug-in names must 
start with NP. y 6 usl 

The plug-in file type depends on the platform: 

• MS Windows: .DLL (Dynamic Link Library) files 

• Unix: . so or . dso (Shared Objects) files 

• Mac OS: PowerPC Shared Library files or 68K code resources 

This guide describes developing plug-ins. For information about the C or C++ languages or their svntax 
and usage, see your language documentation. 
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[Top] [Overview of Plug-in Structure] 



Plug-ins and Platform Independence 

A plug-in is a dynamic code module that is native to the specific platform on which the Netscape 
Communicator runs. It is a code library, rather than an application or an applet, and runs only from 
Communicator. Although plug-ins are platform-specific, the Plug-in API is designed to provide the 
maximum degree of flexibility and to be functionally consistent across all platforms. This guide notes 
platform-specific differences in coding for the MS Windows, Mac OS, and Unix platforms 

You can use the Plug-in API to write plug-ins that are media type driven and provide high performance 
by taking advantage of native code. Plug-ins give you an opportunity to seamlessly integrate platform- 
dependent code and enhance Communicator's core functionality by providing support for new data 
types. 

Plug-ins can take their place beside platform-native interapplication architectures such as OLE and 
OpenDoc, and platform-independent programming languages such as Java and JavaScript. 

. OLE and OpenDoc are powerful, general-purpose component software systems, and components 
developed for these systems are relatively complex and heavyweight. Netscape plug-ins are 
designed specifically to extend Netscape Communicator in specific, content-driven ways and are 
therefore relatively simple and lightweight. J ' 

. Java applets are secure and inherently cross-platform, but developing applets requires codine in a 
new language with new development tools. Plug-ins can be written in C or C++ using existine 
development tools, making it easier to leverage existing code and platform-specific operating 
system capabilities. v 6 

[Top] [ Overview of Plug-in Structure ] 



Windowed and Windowless Plug-ins 

You can write plug-ins that are drawn in their own native windows or frames on a web page 
Alternatively, you can write plug-ins that do not require a window to draw into. Using windowless olue- 
ins extends the possibilities for web page design and functionality. 

• A windowed plug-in is drawn into its own native window on a web page. Windowed plug-ins are 
opaque and always come to the top HTML section of a web page. 

• A windowless plug-in need not be drawn in a native window; it is drawn in its own drawing 
target. Windowless plug-ins can be opaque or transparent, and can be invoked in HTML sections. 

Whether a plug-in is windowed or windowless depends on how you define it. For more information see 
"Drawing, and E vent Handling . " ' 
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The way plug-ms are displayed on the web page is determined by the HTML tag that invokes them This 
is up to the content developer or web page author. Depending on the tag and its attributes, a plug-in can 
be visible or hidden, or can appear as part of a page or as a full page in its own window. A web paee can 
display a windowed or windowless plug-in in any HTML display mode; however, the plug-in must be 
visible for its window type to be meaningful. For information about the way HTML determines clue-in 
display mode, see " Using HTML to Display Plug -ins " * oeiermmes plug-m 

NOTE. 1 71,6 ^"dowed P ,u g" in w *s the only plug-in type in Navigator 2.0 and Navigator 
3.0. Windowless plug-ins are currently not supported on the X Windows platform. § 



[Top] [Windowed and Windowjess Plug-ins] 



Using HTML to Display Plug-ins 

When a user browses to a web page that invokes a plug-in, how the plug-in appears (or does not appear) 

depends on two factors: ff^j 

• The way the developer writes the plug-in determines whether it is displayed in its own window or 
is windowless. 

• The way the content provider uses HTML tags to invoke the plug-in determines its display mode- 
whether it is embedded in a page, is part of a section, appears on its own separate page or is 
hidden. v & ' 

This page discusses using HTML tags and display modes. For information about windowed and 
windowless operation, see " Windowed and W indowlp^ Pl"g r jns " 

For a description of each plug-in display mode, and which HTML tag to use to achieve it, go on to 

Pl^ For details about the HTML tags and their attributes, go on to "HTML Taes 

for Plug-in Disp lay . H b 

• Plug-in Display Modes 



HTML Tags for Plug - in Display 



[lop] 



Plug-in Display Modes 

Whether you are writing an HTML page to display a plug-in or developing a plug-in for an HTML 
author to include in a page, you need to understand how display mode affects the way plug-ins appear. 

A plug-in, whether it is windowed or windowless, can have one of these display modes: 
• embedded in a web page and visible 
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embedded in a web page and hidden 
displayed as a full page in its own window 



An embedded plug-in is part of a larger HTML document and is loaded at the time the document is 
displayed. The plug-m is visible as a rectangular subpart of the page (unless it is hidden) Embedded 
plug-ins are commonly used for multimedia images relating to text in the page, such as the Macromedia 
Shockwave plug-m. When Communicator encounters the EMBEDTag i n a document, it attempts to 
find and display the file represented by the src attribute. The height and width attributes of the embed 
tag determine the size of the embedded plug-in in the HTML page. For example, this embed tae calls a 
plug-in that displays video: 



<EMBED SRC="newave.avi" WIDTH=320 HEIGHT=200 

AUTOSTART=true LOOP=true> 

A hidden plug-in is a type of embedded plug-in. It is created by using the hidden attribute of the embi 
tag. A hidden plug-in is not drawn on the screen when it is invoked, hidden overrides the height and 
width parameters if they are included. Here's an example: 



< EMBED SRC="audiplay.aiff " TYPE="audio/x-aif f " HIDDEN> 

NOTE: Whether a plug-in is windowed or windowless is not meaningful if it is invoked 
with the hidden attribute. § 

£ £S£ age Plug ' in iS ! Visible plug " m ^ is not P 3 * of HTML P a 8 e - The server looks for the media 
(MIME) type registered by a plug-in, based on the file extension, and starts sending the file to the 

browser. Communicator looks up the MIME type and loads the plug-in if it finds a plug-in registered to 

that type. This type of plug-in completely fills the Communicator page. Full-page plug-ins are 

commonly used for document viewers, such as Adobe Acrobat. 

NOTE: Communicator does not display scroll bars automatically for a full-page plug-in 
The plug-in must draw its own scroll bars if it requires them. § 

The Communicator user interface remains relatively constant regardless of which type of plug-in is 
displayed. The part of the application window that does not display plug-in data does not change. The 
basic operations of Communicator, such as navigation, history, and opening files, apply to all pages 
regardless of the plug-ins in use. ' 

For more information about the way HTML tags determine plug-in display mode, see "H TML Taos for 
Plug-in Display." 

[lop] r Usine HTML to Disp lay Plup-ins] 



HTML Tags for Plug-in Display 

A plug-in runs in an HTML page in a Communicator window. The HTML author uses the HTML embed 
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and object tags to invoke the plug-in and control its display. 



• EMBED: Display the plug-in as part of the HTML document in a rectangular area of the page. 

• OBJECT : Embed a variety of object types, including, but not limited to, plug-ins, Java 
components, ActiveX controls, applets, and images in an HTML page. 

You can use either of these tags to place a plug-in in an HTML layer or section. Sections are part of 
Netscape Dynamic HTML, and are created with the HTML layer tag. The HTML author can make the 
contents of a section overlay or be covered by other elements included on a page, or manipulate the 
section independently of the rest of the page. For information about the layer tag, see the Dynamic 
HTML in Netscap e Comm unicator. 

This chapter describes only the use of these tags to display plug-ins and support automatic download 
with Jar Installation Manager (JIM). For other uses, see the Netscape HTML Tag Reference. 

[lop] 



EMBED Tag 

The embed tag displays the plug-in as part of an HTML document in a rectangular area of the page. 

Communicator loads an embedded plug-in when the user displays an HTML page that contains an 
embedded object whose MIME type is registered by a plug-in. Plug-ins are embedded in much the same 
way as GIF or JPEG images are, except that a plug-in can be live and respond to user events such as 
mouse clicks. * 

This section is a brief introduction to this HTML tag. For a detailed description, see the entry for the 
embed tag in the HTMLTag Reference. 

The embed tag has the following syntax and attributes: 



<EMBED 

SRC="location" 

TYPE= "MIMEt ype " 

PLUGINSPAGE="instrURL" 

PLUGINURL="pluginURL" 

ALIGN="LEFT" I "RIGHT" | "TOP" | "BOTTOM" 

BORDER="borderWidth" 

FRAMEB0RDER="N0" 
HEIGHT="height" 
WIDTH="width" 
UNITS="units" 
HIDDEN~"TRUE | FALSE 
HSPACE="horizMargin" 
VSPACE="vertMargin" 
NAME="pluginName " 

PALETTE=" FOREGROUND" | "BACKGROUND" 



http://developer.netscape.com/docs/manuals/communicator/plugin^asic.htm 2/13/2004 



' AA* w*.^ J 



fage 1 2 01 1 5 



</EMBED> 



You must include either the src attribute or the type attribute in an embed tag. The src attribute is the 
URL of the file to run. The type attribute specifies the MIME type of the plug-in needed to run the file 
Navigator uses either the value of the type attribute or the suffix of the filename given as the source to 
determine which plug-in to use. 

Use type for a plug-in that requires no data, for example, a plug-in that draws an analog clock or fetches 
all of its data dynamically. For a visible plug-in, you must include width and height if you use type- 
no default value is used. 



New in Netscape Communicator 4.0. The pluginurl attribute is the URL of a JAR file The default 
plug-in invokes JIM with this JAR file URL, rather than loading the URL into a window or displaying 
the default plug-in dialog box. It is recommended that you use this attribute rather than pluginspage. 

The pluginspage attribute is the URL for instructions for installing the plug-in. The JAR Installation 
Manager uses this URL if a plug-in is registered on the user's machine. Starting with Communicator 4 0 
pluginspage points to the Plug-in Finder, which determines which plug-in is required and may invoke ' 
JIM with JavaScript. 

The embed tag has a number of attributes that determine the appearance and size of the plug-in instance 
including these: ' 

• The border and frameborder attributes specify the size of a border for the plue-in or draw a 
borderless plug-in 

• height, width, and units determine the size of the plug-in in the HTML page. If the plug-in is 
not hidden, the height and width attributes are required. 

• hspace and vspace create a margin of the specified width, in pixels, around the plug-in. 

• align specifies the alignment for the plug-in relative to the web page. 

Use the hidden attribute if you do not want the plug-in to be visible. In this case, you do not need the 
attributes that describe plug-in appearance. In fact, hidden overrides those attributes if they are present. 

New in Netscape Communicator 4, 0, Use the name attribute, which specifies the name of the plug-in, if 
the plug-in is communicating with JavaScript. 

MS Windows only: The palette attribute indicates whether the plug-in should use the foreground or 
background (default) color palette. 

For example, this embed tag loads a picture with the imaginary data type dgs. 

< EMBED SRC="mypic.dgs" WIDTH=320 HEIGHT=200 BORDER=25 ALIGN-right> 



Communicator interprets the attributes as follows: 



• src: Load the data file and determine the MIME type of the data. 
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• width and height: Set the area of the page handled by the plug-in to 320 by 200 pixels. Use the 
units attribute if you want to use a measurement other than pixels (the default). 

• border: Draw a border 25 pixels wide around the plug-in. 

• align: Align the plug-in at the right side of the web page. 
Using Custom EMBED Attributes 

In addition to these standard attributes, you can create private, plug-in-specific attributes and use them i 
the embed attribute to pass extra information between the HTML page and the plug-in code. 
Communicator ignores these nonstandard attributes when parsing the HTML. It passes all attributes to 
the plug-in, allowing the plug-in to examine the list for any private attributes that could modify its 
behavior. 

For example, a plug-in that displays video could have private attributes that determine whether to start 
the plug-in automatically or loop the video automatically on playback, as in the following embed tag: 



<EMBED SRC= "myavi.avi" WIDTH=100 HEIGHT=125 AUTOSTART=true LOOP=true> 

With this embed tag, Communicator passes the values to the plug-in, using the arg parameters of the 
NPP_New call that creates the plug-in instance. 



argc = 5 

argn = { "SRC", "WIDTH", "HEIGHT", "AUTOSTART", "LOOP"} 
argv = {"movie.avi", "100", "125", "TRUE", "TRUE"} 

Communicator interprets the attributes as follows: 

• src: Load the data file and determine the MIME type of the data. 

• width and height: Set the area of the page handled by the plug-in to 100 by 125 pixels. 

• autostart and loop: Ignore these private attributes and pass them along to the plug-in with the 
rest of the attributes. 

The plug-in must scan its list of attributes to determine whether it should automatically start the video 
and loop it on playback. 

[Top] 



OBJECT Tag 

The object tag embeds a variety of object types in an HTML page. Among these are plug-ins, Java 
components, ActiveX controls, applets, and images, object tag attributes determine the type of object 
to embed, the type and location of the object's implementation (code), and the type and implementation 
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of the object's data. 



The object tag allows you to invoke another object if the browser cannot support the object invoked bv 
the tag. The embed tag, which is also used for plug-ins, does not. 

Unlike the applet tag, object can contain other HTML attributes, including other object tags nested 
between its opening and closing angle brackets. 

This section is a brief introduction to this HTML tag. For a detailed description see the entrv for the 
object tag in the HTML Tag Reference. ? 



To embed a variety of object types in an HTML page, use the object tag. 

<OBJECT 

CLASSID="classFile" 
DATA="dataLocation" 
CODEBASE= " c 1 a s s Fi 1 e Di r " 
TYPE="MIMEtype " 
ALIGN="alignment" 
HEIGHT="pixHeight" 
WIDTH="pixWidth" 
ID= "name" 



The first set of object tag attributes are URLs. 



• classid is the URL of the specific object implementation. This attribute is similar to the code 
attribute of the applet tag. The URL is used by JIM if a plug-in is not installed or registered on 
the user's machine. Since classid works like pluginurl for the default plug-in, it can use JIM to 
find and install a plug-in. 

• data represents the URL of the object's data; this is equivalent to the src attribute of embed. 

• CODEBASE represents the URL of the plug-in; this is the same as the codebase attribute of the 
applet tag. For plug-ins, codebase is the same as plug i ns page. • ■ 

type represents the MIME type of the plug-in; this is the same as the type attribute of embed. 

height, width, align are basic img/embed/applet attributes supported by object, height and width 
are required for object tags that resolve to embed tags. 

Use the id attribute, which specifies the name of the plug-in, if the plug-in is communicating with 
JavaScript. This is equivalent to the name attribute of apflet and embed. 

It's up to you to provide enough attributes and to make sure that they do not conflict; for example the 
values of width and height may be wrong for the plug-in. Otherwise, the plug-in cannot be embedded. 
When Communicator encounters an object tag, it goes through the tag attributes, ignoring or parsing as 
appropriate. It analyzes the attributes to determine the object type, then determines whether 
Communicator can handle the type. 

• If Communicator can handle the type, that is, if a plug-in exists for that type, all tags up to the 
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closing </object> tag, except param tags and other object tags, are filtered. 



fContentsI rPrevious] [Nftvt] £IrwW| 



i 



Last Updated: 01/15/97 17:35:54 



Copyright © 1997 Netscape J^ommunication^C^orati 



ion 



http://developer.netscape.com/docs/manuals/communicator/plugir^asic.htm 



2/13/2004 



i 



All messages from thread 

From: Andre.as_LajLhenman_n (angYeasl@Jachenmann-net.de) Messaae 1 in thr^n 

Subject: Add toolbar to IE4-taskbar Message 1 in thread 

Newsgroups: comp r o_s.ms r wjndow^p_rogrammer Win32 
Date: 1999/01/26 ~ ~" ' " 

View this article? nnly 

Hello, 

how can I add my own toolbar (like the adress bar) to the IE4-taskbar' 
I know that the taskbar is a "rebar", but I don't know how to add my ' 
own bar. y 

Thanks for any help 
Andreas Lachenmann 

From: Matthew_EJ!js (m J i ejjjs^swan_sea i ac. uk) Messan* 7 in thr« a n 

Subject: Re: Add toolbar to IE4-taskbar Message 2 .n thread 

Newsgroups: cjDjiip^psjns-wiMo^s.pjrp Win32 

Date: 1999/01/27 " ' ... „. ^. , . , 

View this article only 

Andreas Lachenmann <andreasl@lachenmann-net.de> wrote in messaae 
news:36ae2a57.34 717 7 9@news.un i-stuttaart.riP 
>Hello, " ' 

>how can i add my own toolbar (like the adress bar) to the IE4-taskbar? 
>I know that the taskbar is a "rebar", but I don't know how to add my ' 

>own bar. y 

Check out the documentation for IDeskBand 

Matthew Ellis 

m. t . ellis@ Swansea .ac.uk 
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All messages from thread 

From: RaghaygndraJL& (raghu.ki@siri.co.in) M(1 . c: , nfl .... . 

Subject: Adding Toolbar (Plugin) in NeTscape Communicator 9 hread 

Newsgroups: nejfecjjg.d^Ys^g.ins, netscape.devs-client-technical 
Date: 2000/05/18 " 

View this article only 

Hello All, 

la h Hl N^ ir T nt ^ 3 t0 ° lbar " 3 plUgin (or ot *er method) 
to the Netscape Navigator. 

browsed Similar t0 the Yaho ° Com Panion which adds a Toolbar to the 

Hf!ir Si wV he q " eStion ' 1 need to know how the Yahoo Companion was 
developed for netscape. 

You can checkout the yahoo Companion from www.yaho o.com or 
download/install from 

http : //edit . yaho o . com/conf iq/download companion 

I appreciate any kind of help, links to examples, documentation etc. 

Thanks a lot in Advance 
-Raghu 

From: Raahayen^aJCS., (raghu Js@sitLco.in) Messaa^ 9 in thraH 

Subject: Re: Adding Toolbar (Plugin) in Nelscape Communicator 9 
Newsgroups: ngtscaeadgvs:^ netscape.devs-client-technical 

netscape.client.customization " ' w . * u - ^ . 

Date: 2000/05/24 View thrs article only 

Hello All, 

I haven't got any replies to this mail. I hope the question is clear 
it is .... How do I add a Custom Browser Toolbar to Netscape Navigator 
Programmatically? y 

Any Netscape Developers Reading this I searched the 

developer.netscape.com site fully. 

Is there any other links to netscape client development 
I found out how to add a toolbar for IE. 

I am not sure whether i can use the active Component in netscape. 

Thanks again in advance 
-Raghu 

"Raghavendra K. S." wrote: 

> Hello All, 
> 

> I have a requirement to add a toolbar as a plugin (or any other method) 

> to the Netscape Navigator. 
> 

> This is very similar to the Yahoo Companion which adds a Toolbar to the 

> browser. 
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> 



> Rephrasing the question, i need to know how the Yahoo Companion was 

> developed for netscape. 

> You can checkout the yahoo Companion from www.vahoo.com or 

> download/install from " "'" 

> http: //edit . yahoo. com/conf iq/download companion 

> I appreciate any kind of help, links to examples, documentation etc. 

> Thanks a lot in Advance 

> -Raghu 

From: Alex Cohn (alexcohn@n etvision.net.il ) Messaae 3 in thread 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.devs-Dlugins . netscape.de vs-client-technirai 

netscape.client.customization ' v * th - . . 

Date: 2000/05/24 Vje^ihis article only 

f ,t U t so ^ discussion on toolbars in the netscape . devs-plugins forum. 
I think that nobody answered your posting because nobody knows a decent 
answer even though the topic has been dicussed here more than once Feelinc- 
almost useless, y 

Alex 

"Raghavendra K. S." wrote: 

> Hello All, 
> 

> I haven't got any replies to this mail. I hope the question is clear. 

> Jt ls How do I add a Custom Browser Toolbar tc Netscape Naviqato^ 

> Programmatically? 
> 

> Any Netscape Developers Reading this I searched the 

> developer.netscape.com site fully. 

> Is there any other links to netscape client development 
> 

> I found out how to add a toolbar for IE. 

> I am not sure whether i can use the active Component in netscape. 

> Thanks again in advance 

> -Raghu 
> 

> "Raghavendra K. S . " wrote: 
> 

-> ^ u o 1 i ^ t i 



> > I have a requirement to add a toolbar as a plugin (or any ether method) 



> tc the Netscape Navi 



> > 



> > This 



is very similar tc the Y a hoo Companion which aods a Toolbar to th* 
> > browse. 1 : . 



> > Rephrasing the question, i need tc know how the Yahoc Companion was 

> > developed for netscape. 

> > Ycu car; checkout the yahoo Companion from www . yahoo .com cr 

> > download/ install from 

> > http : /,/ edit . yahoo . com/conf iq/download companion 
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> > 

> > I appreciate any kind of help, 

> > 

> > Thanks a lot in Advance 

> > -Raqhu 



links to examples, documentation e~c. 



From: Shahram Javey (^a^.@adobexom) Me^an* a in th rM ^ 

Subject: Re: Adding Toolbar (Plugin) in NeTscape Communicator 9 d 
Newsgroups: nejscap^.devs-pluains 

Date: 2000/05/27 w . 1L . 

View this article only 

Looks like Yahoo Companion (YC) is doing some Windows programminq tricks to 
achzeve the toolbar effect. This is I think how they have doT 11. Spon 
Netscape start, YC is initialized. YC then gets the Window handle to 
Netscape Window, creates a new window using MFC or what have you and adds a 
menubar and a toolbar. The original window is still there (just hidden) You 
can get the original Window by going to the Task Manager (on NT) and use the 
popup menu and issue Maximize. You'll see the hidden Window 

So you might ask, do you really want to do all of this stuff just to add a 
menu bar and a toolbar? Netscape plug-in architecture does not cat^r tt 
developer extending the browser in the same way as IE does (only on windows 
unfortunately) . Even if you get all of this to work on one version of the 
browser on one version of the platform, there is no guarantee "hit it , 
work for Netscape 6. (BTW whatever happened to Netscape 5?) 

feature. W3nt ^ red6Sign Y ° Ur SyStem 50 that At do " not require this 
sj 



"Alex Conn" <alexcohn@netvision.net.il> wrote in messaqe 
news : 392BED81 . FB9CBCBB@netvision . net . il . 

^ y°^ Ca u f u nd discussion ° n toolbars in the netscape . devs-olugins forum 

> I think that nobody answered your posting because nobody knows" a decent 

> answer even though the topic has been dicussed here more than onc e : Feelina 

> almost useless, 

> 

> Alex 

> 

> "Raghavendra K. S." wrote: 

> 

> > Hello All, 

> > 

> > I haven't act anv recM^^ fc r f^c t u~,-, . l. 

. •"„ y -fct-.-.w- -c I nope me question is clear, 

' ' 11 15 now ao I acid a Custom Browser Toolbar to Netscar* Kaviaa-or 

i-rcgrammaticaily? * - 



> > 



> > Any Netscape Developers Heading this i searched th* 

> > developer.netscape.com site fully. 

> > Is there any ether links to netscape client develooment 



> > 



J found out how to add a toolbar for IE. 

u v. • 



> > 1 am not sure whether can use the active Component in 



Thanhs again in advance 
-Raahu 
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Readjhe^&tfjhiuBgmgS^ (27 more lines) 



From: Ferrex ( ferrex@k1ng .nu) 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.devs-Dluains. netscape.devs-client- t^rhnin a i 
Date: 2000/05/26 



yes thats excactly what i need . . 
never found any documentation about this shite 
the documentation within the SDK from netscape Is 
helpfull F 



Message 5 in thread 



V iew thi s article only 



• erm 1 . .not really 



«?« V n? dra K ' S ' <ra 9 hu - k ^iri.co.in> schrieb in im Newsbeitraa- 
39238A27.ClBB99A8@siri.co.in. . . wewsoeitrag. 

> Hello All, 
> 

> 

> Sowsir/ 6 ^ SimUar t0 Yah °° Com P anion whi <* adds a' Toolbar to the 

> 

> Rephrasing the question, i need to know how the Yahoo Companion was 

> developed for netscape. p as 

> You can checkout the yahoo Companion from www. yahoo com or 

> download/install from " 

> I appreciate any kind of help, links to examples, documentation etc. 

> Thanks a lot in Advance 

> -Raghu 

> 
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All messages from thread 

From: BrianUtt (b_utt@yahoo.com) y occono , . . 

Subject: Custom Toolbar fof Netscape Browser MeSSage 1 ,n thread 

Newsgroups: ne.tscape.public.mozilla.general 

Date: 2001-05-15 08:33:24 PST ... 

View this articlR only 

I am attempting to write an application that sets up a custom toolbar 

the netscape browser (in much the same way that google and yahoo have 
done) . 

Is there an API that I can work with in order to find out how to start? 

does anyone have any idea as to how I can find out more information on 
working with the Netscape brower (Navigator and/or Communicator) I am 
sorry to bother this newsgroup, it's just that I haven't found any help 
anywhere else. J ^ 

Thanks! 

-Brian Utt 

From: Gervase Markham (gei-vase.mar kham@univ.oy an ■■!< ) Messaae 2 in thread 

Subject: Re: Custom Toolbar for Netscape Browser message z in thread 

Newsgroups: netscape.pu blic.mozilla genpral 

Date: 2001-05-15 11:43:44 PST w;^ 

View this article only 

> I am attempting to write an application that sets up a custom toolbar 

> the netscape browser (in much the same way that google and yahoo have 

> done ) . 

> Is there an API that I can work with in order to find out how to start? 

You need to write some XUL (netscape.public.mozilla .xpfe and 
•Ittp; //www.-,^ and then tie it up in an XPI 

(netscape. public. mozilla . xpinst ail) . 

> does anyone have any idea as to how I can find out mere informbwicr 

> working with the Netscape brower (Navigator and/or Communicator) t am 

> sorry to bother this newsgroup, it's just that I haven't found arv heir 

> anywhere else. 

If you mean 4.x, you are in the wrong place. The above applies only to 
Netscape 6 (for which you are still in the wrong place, but there it is.) 

Gerv 
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All messages from thread 

From: Ferrex Qmgxmimm) Messaae 1 in thr^d 

Subject: HOW THE HELL ???? message l in thread 

Newsgroups: netscape.devs-plugins 

Date: 2000/06/06 \/;^ a/ *k^ ^ , 

View this article only 

well i seen several posts about adding toolbars /menus etc on netscape in 
this forum ,but the overall answer was allways ..look in some older msa's 
etc. . y 

i didnt #1 find old msg on deja.com or something ,#2 i didnt see any post 
that helped out in anyway about this term and this is quite annoying 
PLEASE netscape developers and others who probably know about this 

is it possible to let the plugin add a toolbar or a menu in ANY way to the 
netscape/IE gui ???????? y 
i.e. like the yahoo companion ?? 

please do not post answers about doing it by dhtml or something in IE 
me and several others need to do this in netscape navigator aswell so 
PLEASE do all us out there the favour and answer it this time 
maybe if this will be answered my trust in newsgroups is restored «/ 

sincerly yours , 
Ferrex 



From: Jason Summers fiason@med-web.com) Messaae 2 in thr^n 

Subject: Re: HOW THE HELL ???? message ^ in thread 

Newsgroups: netscape.devs- plugins 

Date: 2000/06/06 w;^, + u* ^. , 

view this article only 

Ferrex wrote: 
> 

> well i seen several posts about adding toolbars/menus etc . . on netscape in 

> this forum ,but the overall answer was allways ..look in some older msa's 

> etc. . ' 

> i didnu tfl find old msg on deja.com or something ,#2 i didnc see any post 

> that helped out in anyway about this term and this is quite annoying 

> PLEASE netscape developers and others who probably know about this 

> is it possible to let the plugin add a toolbar or a menu in ANY way to the 

> netscape/IE gui ???????? 

> i.e. like the yahoo companion ?? 

> 

> please do not post answers about doing it by dhtml or something in IE ' 

> me and several others need to do this in netscape navigator aswell so 

> PLEASE do all us out there the favour and answer it this time 

> maybe if this will be answered my trust in newsgroups is restored =/ 



Someone once posted some sketchy information on how he thought Yahoo 
Companion managed to get activated at browser startup, but no details 
how to add a toolbar to Navigator have been posted here. 

Most likely, no one here knows how to do it, or is at liberty to tell. 
Best guess is that it will take either some amazing hacking skill, or' 
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information direct from Netscape that will require a special agreement 
with them, or both. As far as I know, it is not documented publicly 
anywhere. J 

h ttp : //developer . netscape, com/support/f aqs/ champions /c 

Even if you do manage to create a toolbar, there's no guarantee that it 
will be feasible to do all the functions you want to do with it. 

This response applies to Navigator 4.x only. Navigator 6 will be very 
different . y 

Jason Summers 

j sson(?med-web . com h ttp: / /home . mie web . com/jason/ 

From: Ferrex (ferreA@klng,nu) Messaae 3 in thread 

Subject: Re: HOW THE HELL ???? Message 6 in thread 

Newsgroups: nets ca pe.devs-pjugins 

Date: 2000/06/07 xr 4U - . 

View this article Qnly 

Well i more and more come to the point to just delete the Navigator and 
forget it ! Its depressing , its that easy in IE , you can use deskbands and 
stuff like that to easily create toolbars and stuff like that ..and hacking 
skills ,well its possible to change the gui of netscape for sure but this is 
buggy like nothing else cause i think the netscape process is different in 
every language/version/etc.. 

this really sucks ,i mean ..doesnt netscape wants to be marketleader or 
something ?? so why the heck is it nearly impossible to do good plugins for 
their browser ..damnit @#%& . 

Jason Summers < j ason@med-web . com> schrieb in im Newsbeitraq- 
393D71A4 .888020F6@med-web.com. . . 
> Ferrex wrote: 



> > 



> > well i seen several posts about adding toolbars/menus etc on netscape in 

> > this forum , but the overall answer was aliways ..look in some older msg's 



" " etc 




> > is it possible to let the plugir ; add a tcoibar or a menu in ANV way to th- 

> > netscape/IE gui ???????? 

> > i.e. like the yahoo companion ?? 

> > 

> > please do not post answers about doing it by dhtml or something in IE ! 

> > me anc several others need to ao this in netscape navigator aswell so 

> > PLEASE do all us out there the isvcur and answer it rh'i^ H n o 

> > maybe if this will be answered my trust in newsgrouos is restored «/ 
> 

> Someone once posted some sketchy information on how he thought Yahoo 

> Companion managed to get activated at browser startup, but no details on 

> how to add a toolbar to Navigator nave been posted here. 
> 

> Most likely, no one here knows how to do it, or is at liberty to tell. 

> Best guess is that it will take either some amazing hacking skill, or 
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> information direct from Netscape that will recuire a special aareemer- 

> with them, or both. As far as I know, it is not documented ^b^cty 
I > anywhere. J 

> 

> htL?:/ /develops 

> Even if you do manage to create a toolbar, there's no Guarantee that it 

> will oe feasible to do all the functions you want to do with it. 

> This response applies to Navigator 4.x only. Navioator 6 will be ve-v 

> different. " ^ y 
> 

> — 

> Jason Summers 

> j ason@med-web . com http: / /home . mi e web. com/jason/ 
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Messages 1-10 from thread 
Next 4 

Jump to [ End of thread ] 

From: suraidt@mv-deia.com ( suraidt@mv-de fa.com^ 
Subject: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.proaramminq wehhrnvA/.QPr c tl 
Date: 1999/09/30 

How to add toolbar like Yahoo companion in IE ? 



Message 1 in thread 



View Ms artjcje. only 



Sent via Deja.com http: //www.deia . com/ 
Before you buy. 



From: Anthony Citrano ( acitrano@maine.rr.com ) 
Subject: Re: How to add toolbar like Yahoo companion in IE 

Newsgroups: mjerosoftpuW^ c +| 

Date: 1999/10/04 ~ — 



Is it possible to do an Explorer Bar or Tool Band in 



VB? 



How? 



/aac 



Message 2 in thread 



View this article only 



<sura3dt@my-deja.c0m> wrote in message news LlL^OlJ^a^IMnrpl . 
> How to add toolbar like Yahoo companion "in IE ?" " ' 

> 



a . com 



> Sent via Deja.com http: //www. deja . com/ 

> Before you buy. 

From: syj_ajt@usa.net ( sura jt@usa.net) 
Subject: How to add toolbar like Yahoo companion in IE 
Newsgroups: mjcrosojL^ ctl 
Date: 1999/09/30 " " 

How to add toolbar like Yahoo companion in IE? 



Message 3 in thread 



View this article only 



Sent via Deja.com 
Before you buy. 



http : / /www, deja ._ com / 



From: Yurong JJn {yM@4MM^3^oorr\) 
Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft,p eti 
Date: 1999/10/01 



Message 4 in thread 



View this article only 



Yahoo installs a BHO that attaches its toolbar to IE. The only question left 
is how does it obtain the handle to the Rebar control in IE. I thought 
IWebBrowser2 would provide a method or property for you to retrieve it, but 
it does not. Anyone got an idea? 
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Yurong Lin 

surajtGusa.net wrote in message <7t0o2c$ohe$l@nnrpl .deja. com> 

>How to add toolbar like Yahoo companion in IE? 

> 

> 

>Sent via Deja.com http: //www . deja . com/ 
>Before you buy. 

From: Hanyu Xiao (gghxiao@n ospam.hotmail mm ) Messaqe 5 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.Dublic.inetsdk.proQramminq.webbrow ser ctl 

Date: 1999/09/30 v/;^^ , 

View this article only 

Yurong Lin <ylin@dial .pipex , com> wrote 

> Yahoo installs a BHO that attaches its toolbar to IE. The only question left 

> is how does it obtain the handle to the Rebar control in IE. I thought 

> IWebBrowser2 would provide a method or property for you to retrieve it but 

> it does not. Anyone got an idea 7 ' 
> 

> Yurong Lin 
> 

In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 

To add a toolbar to IE4 is a different story. If you ask MS, they will 
tell you it's not possible at all, so don't expect to find any methods 
for that purpose in any of the interfaces that MS has provided. 
However, it is doable after quite some hack. I don't want to get to 
the detail here, but as Yurong has pointed out, you need to figure out 
how to get to the handle of the rebar control. 

In short, the easy way out is to implement the toolbar only for IE5. 
Hanyu Xiao 



From: Yurong Lin (yurong^ 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microspft,publicj c ti 
Date: 1999/10/01 ~ 

Thanks, Hanyu. 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 

I have searched MSDN inside out but just can ' 1 find it. Any clue such 
as its title, keywords or URL? 



Message 6 in thread 



View this article on ly 



Yurong Lin 
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On Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 
<gghxiao@nospam . hotmail . com> wrote : 



> 

>Yurong Lin <ylin@dial . pipex . com> wrote 

» Yahoo installs a BHD that attaches its toolbar to IE. The or.lv question le r 

» is how does it obtain the handle to the Rebar control in IE*.' I thoucht" 

>> IWebBrowser2- would provide a method or property for you to retrieve'it, bur 

>> it does not . Anyone got an idea? 

>> 

>> Yurong Lin 

» 

> 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 



> 



>To add a toolbar to IE4 is a different story. If you ask MS, they wiU 
>tell you it's not possible at all, so don't expect to find any methods 
>for that purpose in any of the interfaces that MS has provided. 
>However, it is doable after quite some hack. I don't want to get to 
>the detail here, but as Yurong has pointed out, you need to figure out 
>how to get to the handle of the rebar control. 
> 

>In short, the easy way out is to implement the toolbar only for IE5 
> 

>Hanyu Xiao 
> 



From: Andrew Nosenko (caj3tam@^^ 
Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.DroaramminQ.webbrowser ctl 
Date: 1999/10/01 ~ 



Different ways to do this: 

http: / /msdn. micr osoft . com/workshop/Author/dhtml/howto/Shortcut Icon . asp 
http: //support .microsoft . com/support /kb/articles/Ql 82/0 /34 .ASP 

^ ttfx / / techn e t , micrpso ft_. com / cdon 1 i n e / C on t ent/Cq m p ljete/Internet /Client /IE/technote 
/t ipsauth.htm " " 



Message 7 in thread 
View ^^rticje. oiily 



Regards, 

Andrew Nosenko, 

Senior Software Engineer 

Mead & Company 



Custom look & feel for browser windows: 
htt p: / /www. meadroid. com/wpm/ 

MeadCo HTML printing article and samples on the MSDN: 

ht tp: / /msdn . micros of t. v cpW s cript /d_htmlprint . asp 

Advanced HTML printing: 

http : //www .meadroid . com/scriptx/ 

"Yurong Lin" <yurongl@context . co . uk> wrote in message 
news:37Xi9d8e. 35934 07@msne .com. . . 

Thanks, Hanyu. 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is oni 
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>reg setting that you need to specify. The rest is prettymuch like 
implementing an explorer bar. Search the MSDN for details. 

I have searched MSDN inside out but just can't find it. Any clue such 
as its title, keywords or URL? 

Yurong Lin 



On Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 
<gghxiao@nospam . hotmail . com> wrote : 

> 

>Yurong Lin <ylin@dial . pipex . com> wrote 

>> Yahoo installs a BHD that attaches its toolbar to IE. The only cuestion -ft 

^> is now aoes it obtain the handle to the Rebar control I- I theuah- 

» IWebBrowser2 would provide a method or property for you to retrieved bu* 

>> it does not. Anyone got an idea? ' 

» 

» Yurong Lin 

» 

> 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details 
> 

>To add a toolbar to IE4 is a different story. If you ask MS, they will 
>tell you it's not possible at all, so don't expect to find any methods 
>for that purpose in any of the interfaces that MS has provided 
>However, it is doable after quite some hack. I don't want to get to 
>the detail here, but as Yurong has pointed out, you need to figure out 
>how to get to the handle of the rebar control. 
> 

>In short, the easy way out is to implement the toolbar only for IE5. 

>Hanyu Xiao 
> 



From: Yurong Lin (y !jni@d ia L £i pex, com) 

Subject: Re: How to add toolbar like Yahoo companion in IE 

Newsgroups: microsoft.public.inetsdk.proaramminQ.webbrowser r.tl 
Date: 1999/10/01 ~~~ 



Thanks Andrew. But, unless I am missing something, the URLs you mentioned do 
not seem to be relevant to the creation of tool band, they are about adding 
shortcut icons to favorite URLs or URLs in address bar. I am looking for the 
way to attach a tool band (or toolbar) to IE5, like the Yahoo Companion. 

Thanks 



Yurong Lin 



Message 8 in thread 
View this article 



Andrew Nosenko wrote in message <#At9V5AD$GA. 296@cppssbbsa04> 
>Different ways to do this: 

> http: //msdn. microsoft • com/workshop/Author / dhtml/howto/Short cut Icon. asp 
>h t :.tp . : . / / s upport ._mi croso f t . com/ suppo rt/kb / art i cl e s /Ql 8 2 / 0 / 3 4 . AS P 
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> /tgBauth?£r - miCrOSOf t • ^^donline/Content /Comp ! pfp /Tnr 1 ernet/cn S ntZIEZt echnote 

> 

> 

>Regards, 

>Andrew Nosenko, 

>Senicr Software Engineer 

>Mead & Company 

> 

>Custom look & feel for browser windows: 
> http: / /www.meadroid. com/wpm/ 

>MeadCo HTML printing article and samples on the MSDN: 

>http://msdn. microsoft.com/w orkshop/author/scriDt/dhtml Drint aso 
>Advanced HTML printing: "™ ! 

>h ttp: / /www.m ead roid. com/scriptx/ 
> 

>"Yurong Lin" <yurongl(acontext . co . uk> wrote in message 
> news : 31 f 4 9d8e . 3593407@msnews .microsoft . com . 
>Thanks, Hanyu. 
> 

»In fact a custom toolbar in IE5 does NOT reauire a 3H0. rt ^ only a 
»rec setting that you need to specify. The rest is oretty much lU'e 
>>imp±ementing an explorer bar. Search the MS DM for details. 

>I have searched MSDN inside out but just can't find it. Any clue such 

>as its title, keywords or URL? 

> 

>Yurong Lin 

> 

> 

> 

>0n Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 

><gghxiao@nospam.hotmail . com> wrote: 
> 



Kmdjhe restofMs m^ (34 more lines) 

From: AjTthpny..Cjtr^o ( acitrano@mai ne.rr.com) 

Subject: Re: How to add toolbar like Yahoo companion in IE 

Newsgroups: microsoft.p ublic.inetsdk.proarammina.webbrows er ctl 
Date: 1999/10/04 " 



Message 9 in thread 



View, t h is ■ a irtjcle only 



These URL's are great if you want to quickly add yourself as a favorite, but 
none of them address how to add a custom companion program like Yahoo' 
Companion to IE. Very, very different tasks. 

Anyone else?? 
/aac 

Anthony Citrano 

founder and president, BrainPaste.com, Inc. 

VP, Camden Technology Conference (must attend - http://www.camcon.org) 
Enough about me at h 1 1 p ://www .citrano . com/Team/Anthony/anthony . htm 



Andrew Nosenko <captain@meadroid . com> wrote in message 
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news : #At 9V5AD5GA. 296@cppssbbsa04 . . . 

> Different ways to do this: 

> h ttp://msdn. microsoft.com/work shop/Author/dhtml/howto/ShortcutTrn n £Sp 

> h«p_:^sup|^rt.._mi - 

http: //technet .microsoft . com/cdonline / Content /Complete/Interne / r^ \ ^ / TF / f r 
chnote 

> /tipsauth.htm 
> 

> — 

> Regards, 

> Andrew Nosenko, 

> Senior Software Engineer 

> Mead & Company 

From: Hanyu Xiao (q qhxiao@nospam.hotmail mm ) Messaae 1 0 in thrppri 

Subject: Re: How to add toolbar like Yahoo companion in IE Message i u in thread 

Newsgroups: microsoft. public, inetsdk . programming wphhrnwcor c +i 

Date: 1 999/1 0/01 " w . ... .. , 

Vie w this article only 

See nttp://msdn. microsoft.com/wo rkshop/browser/ext /overview/bands. asp 
Hanyu Xiao 

Yurong Lin <yurongl@context . co . uk> wrote: 

> Thanks, Hanyu. 

> 

> >In fact a custom toolbar in IE5 does NOT require a BHO Tt is on 1 " a 

> >reg setting that you need to specify. The rest is pretty Wh i i k- 

> >implementmg an explorer bar. Search the MSDH for details 
> 

> I have searched MSDN inside out but just can 1 1 find it. Any clue such 

> as its title, keywords or URL? 

> 

> Yurong Lin 



Next 4 

Jump to [ End of thread ] 
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Messages 11-14 from thread 
Prey 10 

Jump to [ Start of th read ] 

From: Yurong Lin f vlin@dial.DiDex.com ) Messanp 1 1 . . 

Subject: Re: How to add toolbar like Yahoo companion in IE Message 1 1 in thread 

Newsgroups: microsoft.pu blic.inetsdk.proaramming wphhrnwcor ct i 

Date: 1999/10/01 w . iL . 

View, this article only 

If fact I have read over that article a number of times, it does talks about 
. lot about other band objects such as explorer bar, bu^ nothing abo^ tool 
band apart from the text below; y 

"A tool band is a band object that was introduced with Internet Explorer 5 
to support the Microsoft® Windows® radio toolbar feature. This feature 

fh^rfiH 3 71 t0 V indow on a band contained by the rebar control 

that holds Internet Explorer 1 s toolbars" 

ITtlt t-ll lay r f ^ T 15 " by selectin 9 it from the Toolbars submenu 

of the View menu or from the context menu that is displayed bv 
right-clicking the toolbar area." 

There isn't even a CAT ID for the tool band. 
Am I missing something? 



Yurong Lin 



Hanyu Xiao wrote in message . . . 

>See http://msdn.microsoft.com/works h op/browser/ext/overview/bands.asp 



> 

>Hanyu Xiao 
> 

>Yurong Lin <yurongl@context . co . uk> wrote: 
>> Thanks, Hanyu. 



>> 



» >In fact a custom toolbar in IE5 does NOT recuire a BHC. It is only a 
» >reg setting that you need to specify. The rest is pretty much like 
» implementing an explorer bar. Search the MSDN fo- details 
>> 

» I have searched MSDN inside out but just can't find it. Any -lue <=u-h 
» as its tine, keywords or URL? 
> > 

>> Yurong Lin 

> 

> 



From: Hanyu Xiao (qqhxiao@no spam.hotma il r.nm) Messaae 12 in thread 

Subject: Re: How to add toolbar like Yahoo c^anion in IE Message n in thread 

Newsgroups: microsoft.pu blic.inetsdk.p rogramminn wohhr^wspr ctl 

Date: 1999/10/01 — \/; M .*u- .♦■ , 

View this article only 

To rephrase what I said in my first post to this thread, a tool band 
is essentially an explorer bar plus a reg setting. You'd implement the 
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tool band as if it was an explorer bar. Then you put in the req 
setting as specified in that MS article, and the explorer bar of you-s 
will automatically show up as a toolbar. You may need to remove the 
CAT ID for this tool band so that it doesn't show up as an explorer bar 
at the same time. 

Hanyu Xiao 

From: rap_o^aJgi to (rapQsa@lliarveAt.com) Messaqe 1 3 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microti ct( 

Date: 1999/10/05 — " w^.,*^ 

View this article nnly 

Adding a tool band a la Yahoo companion is definitely not easy. I've 
managed to add a toolbar button to IE4 by using a browser helper object 
and then "hacking" into the rebar control (getting a handle to it is 
actually fairly easy - just run Spy++ and check out the window 
heirarchy and then enumerate through the windows matching on the class 
until you find the right one) . If you download iHarvest One 
^ww.ihar^.com) and use it with IE4, you'll see this button. For 
IE5, it's easier to use the registry. 

Adding a band, however, is harder because IE does all kinds of tricks 
with maintaining the state of the rebar. I'm not even going to attempt 
it for IE4. Adding the band with IE5 is fairly straightf oward if you 
follow the instructions on their MSDN article. 

However, I did run into one problem - my tool band is named "Radio" in 
the context menu. (So I actually have 2 instances of Radio now in the 
menu). The name shows up fine in the band, but I must be missing 
something. I've got the name in the registry and in the code. Has 
anyone run into this? 

Thanks 
-Scott 



Sent via Deja.com h 1 1 p> / / www . d e j a . c om / 
Before you ouy . 

From: Darjon [Devlin (MarshalLaw@worJd 
Subject: Re: How to add toolbar like Yahoo companion in IE 

Newsgroups: microsoft.public.inetsdk.DroQramming.webbrowser ctl 
Date: 1 999/1 0/07 

> 

> However, I did run into one problem - my tool band is named "Radio" i 

> the context menu. (So I actually have 2 instances of Radio now in the 

> menu) . The name shows up fine in the banc, but I must be missing 

> something. I've got the name in the registry and in the code. Has 

> anyone run into this? 



Its a known bug. There is a KB article describing it. I don't remember 
the KB number off hand, try searching for "Tool band" or "Radio" and 
you should get it. 



Message 14 in thread 
View th is article only 



http://groups.goog]exom/groups?hl=en&lr=&ie=UTF-8&oe=UTF-8&frame-ri 2/13/2004 



^age j 01 j 



Prev 1 0 

Jump to [ Start of thread ] 



©2004 Google 



http://groups.goog^ 2/13/2004 



rage 1 oi i 



All messages from thread 

From: Borland (in^^jn@.sfijyjietcom) 
Subject: IE4 Band Objects 

Newsgroups: borM f 

b^rland.public.delphi.oleautomation, bori^clpuWic.deiphi winapi 
Date: 1998/03/22 " ~ 



Message 1 in thread 



View this article only 



If anyone is interested in testing D3 implementation of IE4 Band Obiects 
let me know. J ' 



From: Thaddy de Koning ( thaddv@cy co.nl) 
Subject: Re: IE4 Band Objects 

Newsgroups: borland.public.delphi.activex.controls.writing , 
borland.public.delphLol eautomation . borland.public.delphi winaoi 
Date: 1998/03/23 



Message 2 in thread 



View this article only 



I am. 



Thaddy 



Borland wrote in message <6f 3 j 4 0$aul8@f orums . borland . com> 

>If anyone is interested in testing D3 implementation of IE4 Band Obiects 
>let me know. J ' 



> 
> 



From: Jeff Rafter (ieffrafter@earthlink.nett 
Subject: Re: IE4 Band Objects 

Newsgroups: borland.public.delphi.activex.controls.writing . 
bMand,p_uM^ borland.public delphi winapi 

Date: 1998/03/23 



Message 3 in thread 



View this article only 



Interested, 

Jeff Rafter, Reaisoft Development 
http : / /www .. realsoft dev . com 



From: Raymond (rnaseef@rci.rutgers.edu) 

Subject: Re: IE4 Band Objects 

Newsgroups: borland,p„uMc,^ 

.borja^^^ borland.public 

Date: 1998/03/23 



i, winapi 



Message 4 in thread 



View this article only 



Would you mind changing you display name? 
Borland wrote: 

> If anyone is interested in testing D3 implementation of IE4 Eand Objects, 

> let me know. 



From: G,P.Carya|hp (genjp@twics.com) 
Subject: Re: IE4 Band Objects 



Message 5 in thread 
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Newsgroups: borland.public.delphi.activex.controls.writing . 
.borianipubHade^ borlandjDublic.delphi winaoi 
Date: 1 998/03/25 " ~ " " ~ " M " 



View this article only 



ADD-ME TOO 
G.P.Carvalho - JAPAN 

Borland escreveu na mensagem <6f 3 j 4 0$aul8<af orums . borland. com> 

>If anyone is interested in testing D3 implementation of IE4 Band Obiects 
>let me know. - ^^=>, 

> 

> 



From: Arien Wiersma ( wierfin@tref.nh 
Subject: Re: IE4 Band Objects 

Newsgroups: borland.publ ic.delphi.activex.controls.writing , 
borlan d.public.delphi.oleautomation , borland.publicdelnhi winaDi 
Date: 1998/03/26 



Message 6 in thread 



Vlewlhis article p„nly 



add me to the list too : ) 



Borland wrote in message <6f 3 j 40$aul8@f orums .borland. com> 

>If anyone is interested in testing D3 implementation of I 

>let me know. 

> 

> 



E4 Band Objects, 



From: Marian Maier ( Maier@home.ivm.de ^ 
Subject: Re: IE4 Band Objects 

Newsgroups: borland.public.del phi a ctivex.controls writing , 
borland.public.delphi.ol eautomation r borland. publicdelnhi winaoi 
Date: 1 998/03/27 



Message 7 in thread 



View this article only 



Hi, 

>If anyone is interested in testing D3 implementation of IE4 Band Objects, 
What are IE4 Band Objects? 
Ciao, MM 

Fon: +49 228 624013 Fax: +49 228 624031 
"Was schiefgehen kann, geht auch schief." 



From: Rudy Ve (thy is (n/elthuis@cww.de) 
Subject: Re: IE4 Band Objects 
Newsgroups: borland.public.delph 

borland. public.delphi.oleautomation borland. p ublic delphi winapi 
Date: 1998/04/02 



Message 8 in thread 



Vie w this article only 



Marian Maier schrieb in Nachricht <351b83da . 707 6258@news ivm de> 

>Hi, 

> 
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>>If anyone is interested in testing D2 implementation of IZ4 Band Obj 
>What are IE4 Band Objects? 

Microsoft Internet Explorer 4.0 allows an application to define and 
create bands that are displayed within the shell and the browser. 

Internet Explorer 4.0 currently supports three different types of band 
objects: Desk Bands, Explorer Bands, and Communication Bands. Each 
type of band serves a different purpose. The following sections 
describe these different band types and their capabilities. 

Desk Bands are band objects that are displayed as a band in the shell 
taskbar or as a floating tool window on the desktop. Desk Bands are 
used to display information and to receive input from the user. They 
are available to the user throughout the entire Microsoft Windows 
session. Desk Bands are supported in shell versions 4.71 and later. 

Explorer Bands are band objects that are displayed in a browser 
window They usually contain information or supply tools that are 

?« i % * ?k" While USin9 thS browser - These bands are displayed 

to the left of the current view and normally receive user input that 
results m some action being performed. Explorer Bands are supported 
in browser versions 4.71 and later. 

Communication Bands are band objects that are displayed in a browser 
window. This can be a Windows Explorer window or an Internet Explorer 
4.0 browser window. Communication Bands are normally used to relay 
information to the user. These bands are displayed below the current 
view and don't usually accept user input. Communication Bands are 
supported in browser versions 4.71 and later. 
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All messages from thread 

From: Zachar7.Tum.er (ztMnex@bindview.com) M««wn» 1 in thr^ 

Subject: Plugins for IE Message 1 in thread 

Newsgroups: microsQ^ 

microsott.p.uMc.wind ows.inetexp iorer ie^rirt_n_nQ ' ViPwth 1 

QtosoJLPuMc.,w ^ -ew jnis article on ly 

Date: 2000-09-30 13:36:00 PST ~ " ~ " 

Does anyone know how I can develop a plugin for Internet Explorer' Anv 
links to MSDN topics would be grateful. " 

Thanks, 

Zachary Turner 

Su ^ Messa 9 e 2 in 

Newsgroups: microsoft.public.inetexp l orer.ie4.activex contrl 

™crpj^ - lJL ' s 3 Wcie_ Qn\y 

Date: 2000-10-05 15:12:27 PST * ~ 

Developing a plugin for IE is bsically just like developing a plugin for 
Plgun^PI- main CaVSat ^ IE limited su PP°rt for Netscape's 



http://support.mic rosoft.eom/support/kb/articles/ql66/6/94 . 



asp 



To get started, download the Netscape Plugin SDK for Windows: 
.kt^^//Lom.^^ 

There's a sample called WinTemplate that is basically a skeleton pluqin 
project for Visual C++, it's a great starting point. 

Hope this helps, 



Dan Mohr 

Microsoft Developer Support 
Internet Client Development 



"Zachary Turner" <zturner@bindview. com> wrote in message 
: GEr E 5 ^ 3 4 ^5 7 $ 3 y 3 ,.__5 9 0 9 1 8ft yp ho on . austin .rr.com... 

> Does anyone know how I can develop a plugin for Internet Explore-"- Anv 

> links to MSDN topics would be grateful. 
> 

> Thanks, 

> Zachary Turner 



> 
> 
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Messages 1-10 from thread 

From: Jajnes_nokess aamest@sympMcja,ca) Messaae i in thr« a H 

Subject: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscap^deys-piujins 

Date: 2000/01/12 4U . , 

View this article only 

Whats the general consensus on YCompanion. Its tight integration with 
the browser and the fact that no other portal offers one quite like it 
leads to believe that there is more going on? 

Can anyone enlighten me on this, I would like to create a custom toolbar 

3S well 

regards, 
James 

From: Daniel Vernon (dvernonOemeriiat mm) Messaae 2 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs- plugins 

Date: 2000/01/13 ... ... . 

View this article only 

Man... 11/3/99, there was posting by someone who claimed to know how 
companion worked. He even offered to explain it to me if I was interested 
but I never replied. If you had come here 10 days ago you would have seen' 
the posting Anyway, I will search my inbox and see if the newsgroup sent me 
a copy of his reply. K =><="i- me 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on' 
> 

> as n weli° ne enli9hten me on this ' 1 would like to create a custom toolbar 
> 

> X eCjGrdS , 

> James 



From: James Tinkess (iamestOsvmpatico M ) Message 3 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs- plugins 

Date: 2000/01/13 \/;^,*u* , 

View this article only 

Any pointers would be greatly appreciated. I have really scoured the search 
engines and have gotten very little info. 

thanks, 
j ames 



Daniel Vernon wrote: 



> Man... 11/3/99, there was posting by someone who claimed to know how 

> companion worked. He even offered to explain it to me if I .was interested, 
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> L "!T 6r " Plied - * f had here 10 days ago you would have seen 

> .he posting Anyway, I will search my inbox and see if the newsgroup sent me 

> a copy of his reply. * ^ fc 

> 

> James Tinkess wrote: 
> 

> > Whats the general consensus on YCompanion. Its tight integration wi'h 

> > the browser and the fact that no ether portal offers one auite iik-V- 
> leads to believe that there is more going on? 



> > 



> > Can anyone enlighten me on this, I would like to create a custom toolbar 

■* as v^e^i 



> > 



> > regards, 

> > James 

From: SyndSLJayifeesg (sja^abpse@agencyxom) Message 4 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/01/13 ... . 

view this article p nly 

done'^ 6 " like t0 h6ar anyone ' s thou 9hts on how that Yahoo Companion is 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more goina on" 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

From: Vauqhan Knight ( vauqhan@reason.com.au ) Message 5 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or nop 
Newsgroups: netecape.devs-plugins 

Date: 2000/01/18 ~ ~ View thjs^rtic^ 

ok, 

it's a deal with netscape. there's a fair bit of i'll scratch your back, 
you scratch mine going on. 

firstly, YC is a plugin that associates itself with the netscape default 
mime-type. so that's EVERY mime type. therefore, you load up a html page, 
a *.swf page, a *.avi file, and it loads. it doesn't touch the files, and' 
if need be, the appropriate plugin for that file loads and takes care of it. 

this way, it appears to be perminently there. how it gets itself onto the 
toolbar is where yahoo and netscape start exchanging funds. rumour is that 
yahoo got some inside development info for a price. 

so, your can either be very lucky, or you can pay netscape the funds to have 
them supply the code. 
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i've given up on toolbars, it's all up hill 
Vaughan 

James Tinkess wrote: 



> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more goinc on? 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

From: James Tinkess (iamest@sympatico.ca ) Message 6 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or nop 
Newsgroups: netscape.devs- plugins 

Date: 2000/01/18 VLewJhis article 0J3! y 

Thanks for the info, doesnt look like its going to be an "off the shelf" job:-( 
Vaughan Knight wrote: 

> ok, 
> 

> it's a deal with netscape. there's a fair bit of i'll scratch your back 

> you scratch mine going on. ' 
> 

> firstly, YC is a plugin that associates itself with the netscape default 

> mime-type. so that's EVERY mime type. therefore, you load up a html page 

> a *.swf page, a * . avi file, and it loads. it doesn't touch the files, and' 

> if need be, the appropriate plugin for that file loads and takes care' of it. 

> this way, it appears to be perminently there. how it gets itself onto the 

> toolbar is where yahoo and netscape start exchanging funds. rumour is that 

> yahoo got some inside development info for a price. 
> 

> so, your can either be very lucky, or you can pay netscape the funds to have 

> them supply the code. 
> 

> i've given up on toolbars, it's all up hill. 
> 

> Vaughan 
> 

> James Tinkess wrote: 
> 

> > Whats the general consensus on YCompanion. Its tight integration with 

> > the browser and the fact that no other portal offers one cuite like "it 

> > leads tc believe that there is more ooinc on? 



> > 



> > Can anyone enlighten me on this, I would like to create a custom toolbar 

> > as well 

> > 

> > regards , 

> > James 
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From: Marc Hansen ( mhansen©enar.sai.com ^ Messaae 7 in th ro3 H 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-pluflins 

Date: 2000/02/08 " ... t . . _ , 

View this article only 

check out http : //www. icsof t . com/ 

They've created a plugin ( jc_activedoc) that embeds a document from an 
active document server full page in netscape. The toolbar (s) from the 
server show up too. Unfortunately, they don't do menu merging. 

So it seems like it's possible. 

here's a posting from netscape. plugins that also mentions toolbars 
(the subject was "Plugin-in Menus") : 

Eric wrote in message <389CD64B. DDED820B@noonetime com> 
>Hi, 

>I would like to create a plugin with a menu, does anybody know where 

ll^ilt L l 9 ?K d docum ?" t ? t ion on this or =an anybody give me some example 
>code? Anything would be greatly appreciated. I have gone throuah 
>Netscapes documentation and have not been able to find what I am looking 

^ f J** • 

> 

>Thanks in advance, I would greatly appreciate anything that would be 
>nelpf ul . 

>Eric 



> 



You can use normal menus as well as the popup ones in your plugin both have 
a simple solution. * 

If you are in Windows, then First you subclass the Netscape window (client) 
with your own window 

which will have the menu. Specify it in the WNDCLASS structure, and reaister 
the Window, for the y 

popup menus you can respond to WM_CONTEXTMENU message with TrackPopupMenuEx 
If you are using MFC then Subclass the Window using CFrameWnd with parent 
window as the subclassed window 

With this window you can put Menus as wel as toolbar etc in your plugin 

Best of Luck 
Bhushan 



James Tinkess wrote : 

> 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

Marc Hansen j Silicon Graphics ] MineSet Data Minina & Visualization 
mhansen@engr.sgi.com I 650.933.4606 : http.: / / www . min eset . soi . com 
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From: Alex Cohn ( alexcohn@netvision. net. in Messaop R in thr^n 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscap^deys-plugins 

Date: 2000/02/09 "~ x/ . ... „ , 

View th is article only 

It's no big deal to show toolbars in the plugion window. The trick of Yahd 
Comamon is that it seems to be a plugin that gets loaded when Netscape is 
launched (no matter what URL it points to) and stays active no matter where the 
user surfs. And its additional toolbar is just one of the Netscape toolbars 
with the same look-and-f eel . ' 

Alex 

Marc Hansen wrote: 

> check out http: //www. j csof t . com/ 

> They've created a plugin ( jc_activedoc) that embeds a document from an 

> active document server full page in netscape. The toolbar (s) from the 

> server show up too. Unfortunately, they don't do menu merging. 

> So it seems like it's possible. 

From; DJVfemon (d)iM!m@m^g!^m) Message 9 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/02/23 v/ . f . . . 

View this articje pnjy 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more goina on? 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

I was thinking about this and then a possibility came to mind. As it turns 
out, any process can write display info to any window handle if you know 
the window id. For example, the plugin I designed basically spawns a 
seperate app and passes the window handle to the app as a command line 
parameter. Then I am able to draw to the canvas inside netscape from a 
seperate process. When I do this and the plugin is destroyed, the process 
will keep running (unless I tell it to close in the plugin destructor... 
which I do) . 

So, with this in mind, I was thinking about the Unix command XTree... (oj 
something like that). XTree allows you to search for a windows siblings and 
parent. As it turns out, a plugin canvas in Linux is about the 11th 
ancestor of the root window. In theory, if you back traced enough, you 
could get the window handle of the netscape HTML display canvas... and the 
HTML display canvases immediat parent. What would stop you from resizing 
the display window? Or even adding a new window to the displaced area? Mind 
you, this is all theoretical. But, I could resize netscapes window to make 
roo for my "ToolBar"... create a new child window in the toolbar area and 
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pass that to a seperate process. Then, even if the plugin gets destroyed 
the seperate process keeps running and displaying to the window I created. 

If the seperate application was DDE enabled, this might explain how it 
tells netscape to go to urls when you press on certain buttons. 

Just a thought. 

From: John Martm Qn^^i@[eBsm£mLSM) Message 10 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or nop 
Newsgroups: netscape.devs r pjugins 
Date: 2000/02/27 ~™ ' 

Yiewjhis article only 

> So, with this in mind, I was thinking about the Unix command 

> XTree... (or something like that). XTree allows you to search 

> for a windows siblings and parent. As it turns out, a plugin 

> canvas in Linux is about the 11th ancestor of the root 

> window. In theory, if you back traced enough, you could get 

> the window handle of the netscape HTML display canvas... and 

> the HTML display canvases immediat parent. What would stop 

> you from resizing the display window? Or even adding a new 

> window to the displaced area? Mind you, this is all 

> theoretical. But, I could resize netscapes window to make roo 

> for my "ToolBar " . . . create a new child window in the toolbar 

> area and pass that to a seperate process. Then, even if the 

> plugin gets destroyed, the seperate process keeps running and 

> displaying to the window I created. 
> 

> If the seperate application was DDE enabled, this miaht explain how it 

> tells netscape to go to urls when you press on certain buttons. 

That's absolutely correct. Under Windows you can 1 hijack 1 pretty 
much any window and write to it. You can also intercept messages 
to react to events. But because of the insertion of a registry 
key under a Netscape's registry area, I • doubt this is what 
they're doing. 

The other piece of software that Vaughan was referring to was 
ThirdVoice ( www. thirdvoice . com ) . They have just released a 
Netscape version of their software. They do a similar thing to 
Yahoo, but they start painting in the actual rendering area. 
Now, I can't be 100% sure, but I think they're using the Yahoo 
hack. I *think* I saw something about 'Loading Yahoo in the 

splash screen when Netscape starts up. Has anybody else noticed 
this? 

John . 
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Netscape 6.0 Released 

by David Flanag an 
11/16/2000 



Print 

G3 ErnaLLarticleJink: 
(£•» Blog this 



Netscape has released the final version of the Netscape 6.0 Web 
browser/application suite. You can read about Netscape 6.0 and download a 
network installer for it from the Netscape Web site. You can also order • 
Netscape^ on CD for US$5.95. According to an article on the New York 
T imes Web site, the Netscape 6.0 CD will also be distributed to end users in 
"numerous magazines owned by Time Warner." (Netscape is owned by 
AOL, which is in the process of acquiring Time Warner.) To promote the 
new browser, Netscape has also announced a sweep stakes for Netscape 6.0 
users. (Note that the name of the product is now officially "Netscape," which 
is what people have been calling it for a long time, instead of "Navigator" or 
"Communicator.") 

The release of Netscape 6.0 does not include fixes for any of the bugs 
mentioned in my earlier article. That article included a petition (which was 
signed by over 1,300 Web developers) directed to the Netscape Product 
Delivery Team (PDT) asking them to delay the final release of Netscape 6.0 
until pending standards-compliance bugs were resolved. No members of the 
PDT responded before the release, but according to Eric Krock, the Group 
Product Manager for Tools and Components at Netscape, the members of the 
PDT did review my article. However, they did not agree that the bugs I 
mentioned were severe enough to delay the release. Eric's opinions on the 
general software engineering dilemma of fixing bugs versus shipping a 
product are described in an es.say.he_wote shortly before my article 
appeared. After the release of Netscape 6.0, Eric offered the following 
official response from Netscape, which is included verbatim here: 

As has been proven by published test suites and verified by 
independent experts, Netscape 6 has the best standards 
compliance of any browser ever released. It supports more Web 
standards, more deeply, more consistently across more platforms 
than any other browser available today. Its release is great news 
for Web developers because now they can use Web standards to 
develop the kind of Web content, services, and applications they 
have always wanted to create and enable users to access them 
from any of the platforms or devices that the Netscape Gecko 
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browser engine runs on. 

Like all softwar e that ever has ship pe d or ever will ship 
Netscape 6 is being released with some known bugs, including 
some that affect standards compliance-but it has fewer of these 
than any other browser. Netscape carefully revieweH all open 
bugs, including those cited in D^illDanagan's recent essay, 
prior to releasing Netscape 6, and is convinced that the 
remaining limitations are minor and well documented and pale 
in comparison to the benefits of enabling development to such a 
powerful platform of open standards. It would be wrong to 
leave Web developers handcuffed to the limitations of older 
browsers any longer than absolutely necessary. Because 
Netscape 6 has shipped, Web developers can start building 
applications that will transform the Internet from a collection of 
static HTML pages to a rich experience of powerful, cross- 
platform, cross-device Web applications that will revolutionize 
the software industry. Users can begin upgrading from older, 
less standards-compliant browsers and benefiting from both ' 
these next-generation Web applications and from the innovative 
new features of Netscape 6 itself. 

Thanks to Netscape 6, the Web no longer has to wait for the 
promise of standards-based Web applications, but can start 
building and using them today. 

The release notes for Netscape 6 include a list of user-visible bugs. The 
developer release notes contain a list of standards-compliance bugs that may 
affect Web developers. Neither document is a complete list of bugs; user- 
visible bugs were listed only if they were considered severe enough, and 
standards-compliance bugs were listed only if they had been "nominated" for 
listing by someone in the Mozilla developer community. Both lists of bugs 
contain links to the Mozilla project's bugzilla database, from which you can 
get full details about the bugs and their resolution. Netscape is to be 
commended for being so open about the outstanding bugs, and it is important 
to remember that Netscape 6.0 is a huge piece of software with very good 
standards compliance and many features that are not buggy. 

CNET has written a thorough review of Netscap e 6.0 and awarded the 
product a rating of 7 out of 10. The review is worth reading because it 
explains many of the interesting new features included in this release. It also 
contains some hard performance numbers that compare Netscape 6.0 with 
Navigator 4.7 and Internet Explorer 5.5. I'm not aware of any other formal 
product reviews for Netscape 6.0, but there are discussions of it at the 
slashdot and mozillazine Web sites. (There is also another slashdot 
discussion, although it is not as directly relevant.) 

My personal experience with Netscape 6.0 confirms my opinion that it is still 
beta-quality software (at least on Linux). The installer application froze up 
part way through the first two attempts to download Netscape 6.0 (this might 
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be related to heavy network traffic, but the installer itself also froze with a 
blank gray screen). Once I got Netcape installed, it seemed to display the 
Web sites I visit frequently just fine. I was dismayed to discover, however 
that it still prints out debugging messages when it starts, when it exits and 
when it loads a page. I'm an old-fashioned Unix user: I like to start 
applications by typing its name in a terminal window. If I don't want to be 
barraged by debugging craft, I've got to redirect the output of Netscape 6 0 
to /dev/nuli. Another nit that got my goat was the -version flae- when 
Netscape is started with this flag, it is supposed to print out its version 
number and other version information. Instead, it just displays the text 
"version info" (after displaying the usual startup debugging messages). 

The vast majority of users will launch Netscape by clicking an icon on their 
desktop. They will never see this debugging output, and will never use or 
even know about the -version flag. So whafs the problem? For me, it's an 
issue of trust: As a programmer, I evaluate bugs like these as a sign of 
sloppiness, and I assume (whether justifiably or not) that there is similar slop 
throughout the product. If the release schedule was so rushed that no one had 
time to fix trivial things like this, what else wasn't cleaned up? 

Despite my unease with Netscape 6.0, its time to move on. Mv petition was a 
last-minute, last-ditch attempt by myself and the more than one thousand 
Web developers who signed it to influence Netscape's release schedule We 
failed, and now that Netscape 6.0 has been released to the world, our 
opinions about the maturity of the product are no longer relevant. I continue 
to believe that the release of Netscape 6.0 was premature, but I am not a 
product reviewer, and I cannot predict (nor do I want to influence) how 
Netscape 6.0 will be received by the general user community. 

While many of us in the Web development community may be disappointed 
that Netscape was not able to release a more robust browser, the fact is that 
the browser has been released, and people are going to start visiting our Web 
sites with it. Let's make the best of the situation. Remember that despite its 
problems, Netscape 6.0 does have better standards .^mp lian^ than Internet 
Explorer 5.5, and its release marks the beginning of a new, standards-based 
era for Web developers. Although the transition to that new era may be 
rockier than we'd like, it is time to get started. Get yourself a copy of 
Netscape 6.0, test the Web sites you maintain with it, report anv hn gs you 
find in it, and start coding to the HTML, XHTML, XML, DOM, CSS, and 
ECMAScript Web standards! 
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Netscape DevEd q e 



The DevEdge RSS-News Ticker Toolbar 



Marcio Galli, Netscape Communications 
Published 14 Jul 2003 ( Feedback ! 



Introduction 

The DevEdge News Ticker Toolbar is simple to install and provides a convenient way to get the latest news from DevEd E e or other 
online news sources Th IS browser extens.on was based on the DevEdge Toolbar technote It dynamicallv loads micle headli 
from remote RSS files and displays them on the toolbar using XUL, JavaScript, and XML-based SSs The^ Lture 



lines 
are: 



• News ticker that rotates news from external news web sites (RSS feeds). 

• Option to choose news source (DevEdge, C|Net, and NYT). 

• Integrated quick access search. 



' " " J— ' - • ■ » ■ ' 





You can choose 
the headlines source: 
DevEdge, qNet, or NYT 



Quick access menu 
allows you to access 
all the headlines. 




IrrttrTarjonatoed Domain Sa ires QDtf) Support h N«stape7 
the;:Caro^selBabr^ 

Accessing web Service** Netscape 7.1/Moafla 1.4 U»ng WSTX Proxyr^j 
;' The 9e*Ttf»;ffcr »* M&k^iiri/'; •> : .-. - ;. .:. ; '^^^VSP 

: Hw*t^^6fff& ■■■■ ; ^ 

Starrfartte^ased CotapOAj Tablet of Oorttents WUost ^CTOCVVldge^ 

The liT^portahbe of Conrect Canmendrg 
The XSLT^swaSa^t Interface In Gecko 



News Ticker rotates headline 
DevEdge, C|Net and NTT RSS 
One click jumps to the article 



Overview 

^f S l 00 .'^ 35 im P'^ ent ^ usi "8 XUL and JavaScript. To leam specific details about how this toolbar was implemented please 
refer to the the or.g.nal DevE tfge Tpfljbar.techn.pu:. This section covers the specific details of loading and showing RSS 

Introduction to RSS 

In short RSS (Really Simple Syndication) is an XML-based format that allows syndication of articles. The original version was 
created by Netscape as a means of building extensions for its portal. Today RSS is widelv used to syndicate news articles ThT 
newer vers.on allows syndtcat.on with richer meta-data description. For specific information on RSS please consult the RSS 2.0 

pages . * — 

Here is how the DevEdge RSS file looks like: 
Figure 1 : RSS file example based on DevEdge news articles i 



<?xml version»"l . 0" encodina«**UTF-e"?> 
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<rss version* "2 . 0"> 
<channel> 

<title>DevEdge Viewsource</title> 

<link>http : / /devedge . netscape . com/views ource/</link> 
<language>en</ianguage> 

<description>Recent additions to DevEdge Viewsource</description> 
<lastBuildDate>Mon, 30 Jun 2003 09:38:58 GMT</lastBuildDate> 
<copyright>2000-2003 Netscape Communications</copyright> 

<item> 

<title>Article K/title> 

<lin)c>http: //my. website/link-for-the-articlel/</link> 
<author>Bob Clary</author> 

<category>Article</category> 

<pubDate>30 Jun 2003 00:00:00 GMT</pubDate> 

<description>Here should be a description to article 1 . . . </descript ion> 
</item> 

<item> 

<title>Article 2</title> 

<link>http://my.website/link-forrthe-article2/</lin)t> 
<author>Marcio Galli</author> 

<category>Article</category> 

<pubDate>30 Jun 2003 00:00:00 GMT</pubDate> 

<description>Here should be a description to article 2 . . . </description> 
</item> 

</channel> 
</rss> 



The RSSLoader object - Loading RSS via XMLHTTPRequest 

When the toolbar is initiated, a JavaScript code requests a remote RSS file using Mozilla's XMUiTTPRequest inierjrace When 
the requested data is loaded, an array of articles is generated from the RSS. Here is an overview of the class that provides this 
functionality: 

Constructor Summary 

• nsRSSLoader(url) 

when instantiating the object, pass the URL to the RSS datasource. 

Method Summary 

• load() 

Return value: void 

Use this method to trigger the call. 

• setCallback(function ref) 

Return value: void 

Use this method to pass the reference to the function to be called when the data is available. 

• setErrorCallback(function ref) 
Return value: void 

Use this method to pass the reference to the function to be called in case of error 

To iearn more about the RSSLoader implementation check the source code . When the RSS content is loaded, nsRSSLoader 
creates an array of elements for each <item /> that is contained in the RSS file. Each element contains a title and a link. 
Secondly the callback function is executed. 

Note: for the purpose of the toolback ticker, a simple array of titles and links is enough. The implementation code that is 
responsible for the creation of this array is the function nsRSSItem 

Displaying the Headlines 

When the callback is executed, the nsRSSLoader's array of articles is used to populated the UI using the DOM. 



Installation 

Attention: this toolbar is not supported as an official product from DevEdge. It was created simply to demonstrate the technologies 
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involved. 



Netscape 7.x «» XPInaaH for cross-platform installation of packages. A .xpi Hie is basically a .zip file that consists of a iavascrip, 
mstaUer script and the files you want to mstall. The following script triggers the installation of the XPI. To learn more about XPI 
installing and umnstallmg the toolbar, please refer to the original DevEdce toolbar technote. 



die k h ere..tp J ns ta 1J (Engl ish ) 
QLcJeh.eiejjLinstalL(Japanese) 



Resources 



For further reading about XUL we recommend XjdElanet^om's XUL Tutorial. Throughout this tutorial, we will link to XulPlanet 
for more detailed information. The best book on this topic, O'Reilly's Creating Ap^licatipnswith Mozilla. also makes its content 

available for free online at mn/Hev nro in tvn r»l Mn^ilia focKi^n 



— - - - — — — - v w» w. • J\WJ| 

available for free online at mozdev.org in typical Mozilla fashion. 
XUL: 

- XulPlanet.com 

- XulPlanet.com XUL Tutorial 

- O'Reilly's Creating Applications with Mnyilla, also available online at mozdev ore 

- Re mote X UL Tutorial 

- Creatin g a Moz illa Extension 

XPInstall: 

- XPInstalimanual 



Bgmm 10 page top Copyright O 200 i -2003 NttscajK. All rights resencd. Terms of Service j Privacy- Policy 
EindJWLwhy this site is besi viewed in a stan dares -*»mpliam browser. 
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Netscape 6.0 Preview Release 2 Review - Good Software, Bad Timina 

2000.08.09 ' •"■liny 

Jimmy 

Netscape 6.0 preview release 2 came out yesterday, and I can't say I'm uber-impressed 
Netscape 6.0 like it's parent browser Mozilla use the Gecko rendering engine which is 
immeasurably better than the older 4.x Communicator browser, BUT the delivery was less than 
luster compared to the package. 

I read about its release on the omni-potient Slashdot, and proceeded directly to Netcentre to 
grab my own copy. Like most Linux users I dream of the day that I don't have to wrestle with 
Communicator 4.7's many, many problems. This quest has led me to download every other day's 
build of Mozilla and suffer through crash after crash praying the next version will be more stable 
and/or less of a memory hog. Last time Netscape released a preview, it was somewhat thinner 
than Mozilla's nightly builds and actually ran fairly quick (after the horrific wait to open it) so I was 
looking forward to the engine's advancements with Netscape's streamlines I was somewhat 
disappointed. 

Installation Irritation 



I downloaded the installer (from 4.7, because my nightly of Mozilla didn't want to FTP correctly) 
extracted it, ran it, and hung. It happens, right? Kill the process... then sig 9 kill the process 
repeat. Repeat 3 times in fact. I went in search of some release notes and found them quickly 
enough, and after paging through about 4 pages of known issues (*sic*), I found a known problem 
with the linux installer. The notes said it would install fine and then seg-fault, but that it would in 
fact be installed. Now it may not strike some people, but it seems to me that you wouldn't release 
a product with the disclaimer "It'll crash, but don't worry, it got far enough before it did" or the 
rough equivalent. That aside, it wasn't even what was going wrong for me, so I abandoned the 
manual and struck out on my own. In the man-poking-at-car-engine-hoping-random-poke-will-fix- 
problem tradition, I just tried it again. Look at that, reading the release notes apparently fixed the 
problem. Not even doing anything. Just reading the notes. Of course like so many installers the 
bar graph moved in roughly 35% increments after 5 minutes or so at each., and at the end I had a 
brand-spanking-new copy of Netscape. I launched it and got ready for the fireworks. 

■ ■ 

Uber-Unimpressed 



Googkr 



Unfortunately the only fireworks I got were an advertisement. Now this is a 
pet peeve of mine. I haven't even seen the software yet, and I'm being asked 
to sign up for something. I don't even know what. I instinctively smacked the 
cancel button, then again... telling them that I was in fact sure I wanted to 
cancel... because the first cancel button was so ambiguous. The browser 
finally comes up, and I start surfing. Then it occurs to me, I'm surfing in 
German. But I'm not German. Why am I surfing in German? Now this is a problem I'm sure I could 
solve, but I don't want to. Why did my brand new browser decide that I was German? It's 
annoying, and as I was cursing, it crashed. 

Summary 

Now please don't misunderstand me. I love Mozilla, I love what they're doing and I love the 
browser. I also thank Netscape/AOL from the bottom of my heart for releasing Communicator's 
source even if it DID turn out to be useless. But guy's, this was not good judgement. It should 
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have been seemless. Missing features I understand, preview release I understand, crashing 
installer I don't. I am a programmer and I'm a hacker at heart and if the next nightly of Mozilla I 
download doesn't work worth beans I understand. The problem is that Netscape can't follow those 
rules. Communicator is in bad shape which everyone knows and I won't rehash, so that means 
AOUNetscape is just itching to get something out to replace it and save their shriveling market 
share. This isn't the right course though. If people want to know where Netscape 6.0 is going we'll 
download Mozilla and find out. If Netscape releases (to the public) a browser they can disclaim it 
until the cows come home but the average user is going to equate this buggy, German-speaking 
memory pig with the final release of 6.0 and not try it when it IS released. It's that simple. 

Netscape, let Mozilla be you're previews/alpha's and beta's. You have to be the polished 
product. 



J\/\f - End of Rant 
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All messages from thread 

From: A ndreas Lachenmann (a ndreasl@ l ache n man n-net.de) Message 1 in thread 

Subject: Add toolbar to IE4-taskbar 

Newsgroups : comp.os.ms-windows.programmer.win32 

Date: 1999/01/26 View this article only 

Hello, 

how can I add my own toolbar (like the adress bar) to the IE4-taskbar? 
I know that the taskbar is a "rebar", but I don't know how to add my 
own bar. 

Thanks for any help 
Andreas Lachenmann 

From: Matthew Ellis (m.t.ellis@swansea.ac.uk) Message 2 in thread 

Subject: Re: Add toolbar to IE4-taskbar 

Newsgroups: comp. os.ms-windo ws. pro g ram mer. win3 2 

Date: 1 999/0 1/27 View this article only 

Andreas Lachenmann <andreasl@lachenmann-net . de> wrote in message 

n g™sjJ36ae 2 a 5 1 .3471779Gnews .un i-stuttgart.de ... 

>Hello, 

>how can I add my own toolbar (like the adress bar) to the IE4-taskbar? 
>I know that the taskbar is a "rebar", but I don't know how to add my 
>own bar. 

Check out the documentation for IDeskBand 

Matthew Ellis 

m. t . ellisG Swansea .ac.uk 
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All messages from thread 

From: Rag ha ye n ^ (raghu.k@siri .co .in) Message 1 in thread 

Subject: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.deys- netsca pe.dev s-c lien t-technical 

Date: 2000/05/18 View this article only 

Hello All, 

I have a requirement to add a toolbar as a plugin (or any other method) 
to the Netscape Navigator. 

This is very similar to the Yahoo Companion which adds a Toolbar to the 
browser . 

Rephrasing the question, i need to know how the Yahoo Companion was 
developed for netscape. 

You can checkout the yahoo Companion from www . yahoo . co m or 
download /ins tall from 

http : //edit . yahoo . com/ conf iq/download_companion 

I appreciate any kind of help, links to examples, documentation etc. 

Thanks a lot in Advance 
-Raghu 

From: Ragh avend ra K. S. ( raghu. k@siri.co.in) Message 2 in thread 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.devs-plugins, netscape.dev s-client -tec hnic al, 

netscape.client.customization View this article only 

Date: 2000/05/24 

Hello All, 

I haven't got any replies to this mail. I hope the question is clear. 

It is How do I add a Custom Browser Toolbar to Netscape Navigator 

Programmatically? 

Any Netscape Developers Reading this I searched the 

developer.netscape.com site fully. 

Is there any other links to netscape client development 
I found out how to add a toolbar for IE. 

I am not sure whether i can use the active Component in netscape. 

Thanks again in advance 
-Raghu 

"Raghavendra K. S . " wrote: 

> Hello All, 
> 

> I have a requirement to add a toolbar as a plugin (or any other method) 

> to the Netscape Navigator. 
> 

> This is very similar to the Yahoo Companion which adds a Toolbar to the 

> browser. 
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> 

> Rephrasing the question, i need to know how the Yahoo Companion was 

> developed for netscape. 

> You can checkout the yahoo Companion from www r _..y_ahop- com or 

> download/install from - 

> http : //edit . yahoo . com/ conf iq/download_companion 
> 

> I appreciate any kind of help, links to examples, documentation etc. 
> 

> Thanks a lot in Advance 

> -Raghu 

From: Alex Cohn ( alexcohn@netvision . net. il ) Message 3 in thread 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape. devs-plugins . netscape. devs-client-technicaL 

netscape.client.customization View this article only 

Date: 2000/05/24 

You can find some discussion on toolbars in the netscape . devs-plugins forum. 
I think that nobody answered your posting because nobody knows a decent 
answer even though the topic has been dicussed here more than once. Feeling 
almost useless, 

Alex 

i 

"Raghavendra K. S." wrote: 

r 

> Hello All, 
> 

> I haven't got any replies to this mail. I hope the question is clear. 

> It is How do I add a Custom Browser Toolbar to Netscape Navigator 

> Programmatically? 
> 

> Any Netscape Developers Reading this I searched the 

> developer.netscape.com site fully. 

> Is there any other links to netscape client development 
> 

> I found out how to add a toolbar for IE. 

> I am not sure whether i can use the active Component in netscape. 

> 

> Thanks again in advance 

> -Raghu 
> 

> "Raghavendra K. S." wrote: 

> 

> > Hello All, 

> > 

> > I have a requirement to add a toolbar as a plugin (or any other method) 

> > tc the Netscape Navigator. 

> > 

> > This is very similar to the Yahoo Companion which adds a Toolbar to the 

> > browser. 



> > 



Rephrasing the question, i need to know how the Yahoo Companion was 

> > developed for netscape. 

> > You car: checkout the yahoo Companion from www_.^aJioo ._cpm or 

> > download/ install from 

' > http_:_//e_dit . yahoo . com/conf iq/download_compa nion 



http://groups.google.com/groups?^ 2/13/2004 



r r 

Google Groups: View Thre 



Page 3 of 4 



> > 

> > I appreciate any kind of help, links to examples, documentation etc. 

> > 

> > Thanks a lot in Advance 

> > -Raghu 

From: Shahram Javey (sjavey@adobe.com) Message 4 in thread 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.devs-plugins 

Date: 2000/05/27 View this article only 

Looks like Yahoo Companion (YC) is doing some Windows programming tricks to 
achieve the toolbar effect. This is I think how they have done it. Upon 
Netscape start, YC is initialized. YC then gets the Window handle to 
Netscape Window, creates a new window using MFC or what have you and adds a 
menubar and a toolbar. The original window is still there (just hidden). You 
can get the original Window by going to the Task Manager (on NT) and use the 
popup menu and issue Maximize. You'll see the hidden Window. 

So you might ask, do you really want to do all of this stuff just to add a 
menu bar and a toolbar? Netscape plug-in architecture does not cater to 
developer extending the browser in the same way as IE does (only on Windows, 
unfortunately) . Even if you get all of this to work on one version of the 
browser on one version of the platform, there is no guarantee that it will 
work for Netscape 6. (BTW whatever happened to Netscape 5?) 

You may want to redesign your system so that it does not require this 
feature. 

sj 



"Alex Conn" <alexcohn@netvision . net . il> wrote in message 
news : 392BED81 . FB9CBCBB@netvision . net . il . 

> You can find some discussion on toolbars in the netscape.devs-plugins forum. 

> I think that nobody answered your posting because nobody knows a decent 

> answer even though the topic has been dicussed here more than once. Feeling 

> almost useless , 

> 

> Alex 

> 

> "Raghavendra K. S." wrote: 
> 

> > Hello All, 

> > 

> > I haven't got any replies to this mail. I hope the question is clear, 

> > It is How do I add a Custom Browser Toolbar to Netscape Navigator 

> > Programme tically? 

> > 

> > Any Netscape Developers Reading this I searched the 

> > developer.netscape.com site fully. 

;> "> is there any other links to netscape client development 

> > 

> > I found out how to add a toolbar for IE. 

> > I am not sure whether i can use the active Component in netscape. 

> > 

> > Thanks again in advance 

> > -Raghu 
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Read the irejt,ofthis_mesMge^ (27 more lines) 



From: Ferrex ( ferrex@k1ng,nu ) 

Subject: Re: Adding Toolbar (Plugin) in Netscape Communicator 
Newsgroups: netscape.devs-plugins , netscape.devs-client-technical 



Message 5 in thread 



Date: 2000/05/26 



V i ew this a rt i cle only 



yes thats excactly what i need . . 

never found any documentation about this shite . . 

the documentation within the SDK from netscape is . . erm . .not really 
helpfull 

Raghavendra K. S. <raghu . k@siri . co . in> schrieb in im Newsbeitrag: 
39238A27 . ClBB99A8@siri . co . in . . . 

> Hello All, 
> 

> I have a requirement to add a toolbar as a plugin (or any other method) 

> to the Netscape Navigator. 
> 

> This is very similar to the Yahoo Companion which adds a Toolbar to the 

> browser. 

> 

> Rephrasing the question, i need to know how the Yahoo Companion was 

> developed for netscape. 

> You can checkout the yahoo Companion from ww_w^^a^oo M ._com or 

> download/install from 

> ft 1 1 p.: / / e d i t .Y^h99..rS.93.l. c _°_ n .1 A.9 /. downl oad_comp ani on 
> 

> I appreciate any kind of help, links to examples, documentation etc. 
> 

> Thanks a lot in Advance 

> -Raghu 
> 
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From: Brian.ytt (b^jM^^oo^m) 
Subject: Custom Toolbar for Netscape Browser 
Newsgroups: netscape.public.mpzilla.general 
Date: 2001-05-15 08:33:24 PST 



Page 1 of 1 

Message 1 in thread 
View this article only 



I am attempting to write an application that sets up a custom toolbar 
for 

the netscape browser (in much the same way that google and yahoo have 
done) . ^ 
Is there an API that I can work with in order to find out how to start? 
Or 

does anyone have any idea as to how I can find out more information on 
working with the Netscape brower (Navigator and/or Communicator). I am 
sorry to bother this newsgroup, it's just that I haven't found any help 
anywhere else. 

Thanks! 

-Brian Utt 

From: Gervase Markham ( gervase.markham@univ.ox.ac.uk ) Message 2 in thread 

Subject: Re: Custom Toolbar for Netscape Browser 
Newsgroups: netscape.public.mozilla.qeneral 

Date: 2001-05-1 5 1 1 :43:44 PST View thjs article only 

> I am attempting to write an application that sets up a custom toolbar 

> for 

> the netscape browser (in much the same way that google and yahoo have 

> done) . 

> Is there an API that I can work with in order to find out how to start? 

You need to write some XUL (netscape . public .mozilla . xpfe and 

h 1 1 p : / / www . mo z ilia, org /xpfe/xulzef. ) and then tie it up in an XPI 

(netscape . public .mozilla . xpinstall ) . 

> does anyone have any idea as to how I can find out more information on 

> working with the Netscape brower (Navigator and/or Communicator) . I am 

> sorry to bother this newsgroup, it's just that I haven't found any help 

> anywhere else. 

If you mean 4.x, you are in the wrong place. The above applies only to 
Netscape 6 (for which you are still in the wrong place, but there it is.) 

Gerv 
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From: Ferrex (ferrex@k1ng.nu) 
Subject: HOW THE HELL ???? 
N ewsg rou ps : netsca pe , d e vs-p I ugins 



Message 1 in thread 



Date: 2000/06/06 



View this article only 



well i seen several posts about adding toolbars/menus etc . . on netscape in 
this forum , but the overall answer was allways ..look in some older msg's 
etc. . 

i didnt #1 find old msg on deja.com or something ,#2 i didnt see any post 
that helped out in anyway about this term and this is quite annoying . . 
PLEASE netscape developers and others who probably know about this . . 

is it possible to let the plugin add a toolbar or a menu in ANY way to the 

netscape/IE gui ???????? 

i.e. like the yahoo companion ?? 

please do not post answers about doing it by dhtml or something in IE ! 
me and several others need to do this in netscape navigator aswell so 
PLEASE do all us out there the favour and answer it this time . 
maybe if this will be answered my trust in newsgroups is restored =/ 

sincerly yours , 



Ferrex wrote: 
> 

> well i seen several posts about adding toolbars/menus etc . . on netscape in 

> this forum , but the overall answer was allways ..look in some older msg's 

> etc. . 

> i didnt #1 find old msg on deja.com or something ,#2 i didnt see any post 

> that helped out in anyway about this term and this is quite annoying . . 

> PLEASE netscape developers and others who probably know about this .. 
> 

> is it possible to let the plugin add a toolbar or a menu in ANY way to the 

> netscape/IE gui ???????? 

> i.e. like the yahoo companion ?? 
> 

> please do not post answers about doing it by dhtml or something in IE ! 

> me and several others need to do this in netscape navigator aswell so 

> PLEASE do all us out there the favour and answer it this time . 

> maybe if this will be answered my trust in newsgroups is restored =/ 

Someone once posted some sketchy information on how he thought Yahoo 
Companion managed to get activated at browser startup, but no details on 
how to add a toolbar to Navigator have been posted here. 

Most likely, no one here knows how to do it, or is at liberty to tell. 
Best guess is that it will take either some amazing hacking skill, or 



Ferrex 



From: Jason Summers (jason@med-web.com ) 
Subject: Re: HOW THE HELL ???? 
Newsgroups: netscape.devs-plugins 



Message 2 in thread 



Date: 2000/06/06 
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information direct from- Netscape that will require a special agreement 
with them, or both. As far as I know, it is not documented publicly 
anywhere . 

h 1 1 p : //developer .netscape . c om / s upp o r t / fa q s / champi on s / c 1 i e n t _ t ech . html #5,- 5 

Even if you do manage to create a toolbar, there's no guarantee that it 
will be feasible to do. all the functions you want to do with it. 

This response applies to Navigator 4.x only. Navigator 6 will be very 
different . 



Jason Summers 

j a s o n @ me d - we b . c cm h 1 1 p^ /_/ h om e ^. .^rni e we b . com/ j _as on / 

From: Ferrex (ferrex@k1ng.nu) Message 3 in thread 

Subject: Re: HOW THE HELL ???? 
Newsgroups: netscape.devs-plugins 

Date: 2000/06/67 View this article only 

Well i. more and more come to the point to just delete the Navigator and 
forget it ! Its depressing , its that easy in IE , you can use deskbands and 
stuff like that to easily create toolbars and stuff like that ..and hacking 
skills , well its possible to change the gui of netscape for sure but this is 
buggy like nothing else cause i think the netscape process is different in 
every language/version/etc. . 

this really sucks , i mean ..doesnt netscape wants to be marketleader or 
something ?? so why the heck is it nearly impossible to do good plugins for 
their browser . .damnit @#%& . 

Jason Summers < jason@med-web. com> schrieb in im Newsbeitrag: 
393D71A4 . 888020F6@med-web . com. . . 

> Ferrex wrote: 

> > 

> > well i seen several posts about adding toolbars/menus etc . . on netscape in 

> > this forum , but the overall answer was allways ..look in some older msg f s 

> > et c . . 

> > i didnt til find old msg on deja.com or something' ,#2 i Uidnt see any post 

> > that helped out in anyway about this term and this is quite annoying . . 

> > PLEASE netscape developers and others who probably know about this 

> > 

> > is it possible to let the plugin add a toolbar or a menu in ANY way to the 

> > netscape/IE gui ???????? 

> > i.e. like the yahoo companion ?? 

> > 

> > please do not post answers' about doing it by dhtml or something in IE ! 

> > me and several others need to do this in netscape navigator aswell so 

> > PLEASE do all us out there the favour and answer it this time . 

> > maybe if this will be answered my trust in newsgroups is restored =/ ■ 
> 

> 

> Someone once posted some sketchy information on how he thought Yahoo 

> Companion managed to get activated at browser startup, but no details on 

> how to add a toolbar to Navigator have been posted here. 
> 

> Most likely, no one here knows how to do it, or is at liberty to tell. 

> Best guess is that it will take either some amazing hacking skill, or 
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> information direct from Netscape that will require a special agreement 

> with them, or both. As far as I know, it is not documented publicly 

> anywhere. 

> 

> http : / /developer, nets cape .com/ s upport / f a q s /champ i o ns/c 1 i e n t _t e ch . h t ml #5-5 

> 

> Even if you do manage to create a toolbar, there's no guarantee that it 

> will be feasible to do all the functions you want to do with it.. 
> 

> This response applies to Navigator 4.x only. Navigator 6 will be very 

> different. 

> 

> — 

> Jason Summers 

> jason@med-web.com h t tp„i//h ome^. mi e web jjcom^ j_ason / 
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Next 4 

Jump to [ End of thread ] 

From: surajdt@my-deja.com ( surajdt@my-deja.com ) 
Subject: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.proQramming.webbrowser ctl 
Date: 1999/09/30 



How to add toolbar like Yahoo companion in IE ? 

Sent via Deja.com http: //www. deja . com/ 
Before you buy. 

From: Anthony Citrano ( acitrano@maine.rr.com ) 
Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.programming.webbrowser_ctl 
Date: 1999/10/04 



Is it possible to do an Explorer Bar or Tool Band in VB? 
How? 
/aac 

<surajdt@my-de ja . com> wrote in message news ^ 

> How to add toolbar like Yahoo companion in IE ? 
> 
> 

> Sent via Deja.com http: //www. deja . com / 

> Before you buy. 

From: surajt@usa.net (surajt@usa.net) 
Subject: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.programming.we bbrow ser ctl 
Date: 1999/09/30 



How to add toolbar like Yahoo companion in IE? 

Sent via Deja.com htJtjajL//^ 
Before you buy. 

From: Yurong. Lin (yM@^3Lpj&@JLCQm) Message 4 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 

N ewsg ro u ps : microsoft.public.inetsdk.progra mming, vyebbrowser^ctl 

Date: 1999/10/01 View this article only 

Yahoo installs a BHO that attaches its toolbar to IE. The only question left 
is how does it obtain the handle to the Rebar control in IE. I thought 
IWebBrowser2 would provide a method or property for you to retrieve it, but 
it does not. Anyone got an idea? 



Message 1 in thread 
View Jh is art i cle only 



Message 2 in thread 
View this article only 



Message 3 in thread 
View this article only 
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Yurong Lin 

surajt@usa.net wrote in message <7t0o2c$ohe$ l@nnrpl . de ja . com> . . . 

>How to add toolbar like Yahoo companion in IE? 

> 

> 

>Sent via Deja.com ht tp: //www. deja . com/ 
>Before you buy. 

From: Hanyu Xia o (gg hxiao@nospam.hotmail.com ) Message 5 in thread 

Subject: Re: How to add toolbar like Yahoo companion in (E 
Newsgroups: microsoft.public.inetsdk.programming.webbrowser ctl 

Date: 1999/09/30 View this article only 

Yurong Lin <ylin@dial . pipex . com> wrote 

> Yahoo installs a BHO that attaches its toolbar to IE. The only question left 

> is how does it obtain the handle to the Rebar control in IE. I thought 

> IWebBrowser2 would provide a method or property for you to retrieve it, but 

> it does not. Anyone got an idea? 
> 

> Yurong Lin 
> 

In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
re g setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 

To add a toolbar to IE4 is a different story. If you ask MS, they will 
tell you it's not possible at all, so don't expect to find any methods 
for that purpose in any of the interfaces that MS has provided. 
However, it is doable after quite some hack. I don't want to get to 
the detail here, but as Yurong has pointed out, you need to figure out 
how to get to the handle of the rebar control. 

In short, the easy way out is to implement the toolbar only for IE5. 
Hanyu Xiao 

From: Yurong Lin (yurongl@context.co.uk) Message 6 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft, public, inetsd 

Date: 1999/10/01 View this article on ly 

Thanks , Hanyu . 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 

I have searched MSDN inside out but just can't find it. Any clue such 
as its title, keywords or URL? 

Yurong Lin 
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On Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 
<gghxiao@nospam . hotmail . com> wrote : 

> 

>Yurong Lin <ylin@dial . pipex . com> wrote 

» Yahoo installs a BKO that attaches its toolbar to IE. The only question left 

» is how does it obtain the handle to the Rebar control in IE. I thought 

>> IWebBrowser2 would provide a method or property for you to retrieve it, but 

» it does not. Anyone got an idea? 

» 

» Yurong Lin 

» 

> 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 

> 

>To add a toolbar to IE4 is a different story. If you ask MS, they will 
>tell you it's not possible at all, so don't expect to find any methods 
>for that purpose in any of the interfaces that MS has provided. 
>However, it is doable after quite some hack. I don't want to get to 
>the detail here, but as Yurong has pointed out, you need to figure out 
>how to get to the handle of the rebar control. 
> 

>In short, the easy way out is to implement the toolbar only for IE5. 
> 

>Hanyu Xiao 
> 
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From: A ndre w Nosenko (captain@meadroid .com ) Message 7 in thread 
Subject: Re: How to add toolbar like Yahoo companion in IE 

Newsgroups: microsoft.public.inetsdk.programming.webbrowser ctl 

Date: 1 999/1 0/0 1 View . thi&article. only 

Different ways to do this: 

http : //msdn .microsoft . com/workshop/Author/dhtml/howto/Shortcutlcon . asp 
http: //support .microsoft . com/support/kb/articles/Q182/0/34 .ASP 

h ttp: //technet .mi c rosof t . com/cdonline/Content/Complete/Internet / CI i ent /I E /tech note 
/tipsauth.htm 

Regards, 

Andrew Nosenko, 

Senior Software Engineer 

Mead & Company 

Custom look & feel for browser windows: 
http:// www . me adroid . c om / wpm / 

MeadCo HTML printing article and samples on the MSDN: 

http: / /msdn... microsoft . com/ workshop/author /script /dhtmlprint ..asp 

Advanced HTML printing: 

http: //www.m ea droid. com/scriptx/ 

"Yurong Lin" <yurongl@context . co . uk> wrote in message 
news : 37f 4 9d8e . 35 9 3 4 07 @ ms n ews . mi c r q s q f t . com ... 
Thanks, Hanyu. 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
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>reg setting that you need to specify. The rest is pretty much like 
> implementing an explorer bar. Search the MSDN for details. 

I have searched MSDN inside out but just can't find it. Any clue such 
as its title, keywords or URL? 

Yurong Lin 



On Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 
<gghxiao@nospam . hotmail . com> wrote : 

> 

> Yurong Lin <ylin@dial .pipex . com> wrote 

>> Yahoo installs a BKO that attaches its toolbar to IE. The only question left 
» is hew does it obtain the handle to the Rebar control in IE, I thouqht 
» IWebBrowser2 would provide a method or property for you to retrieve it, but 
» it does not. Anyone got an idea? 

» 

» Yurong Lin 

» 

> 

>In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
>reg setting that you need to specify. The rest is pretty much like 
implementing an explorer bar. Search the MSDN for details. 
> 

>To add a toolbar to IE4 is a different story. If you ask MS, they will 
>tell you it's not possible at all, so don't expect to find any methods 
>for that purpose in any of the interfaces that MS has provided. 
>However, it is doable after quite some hack. I don't want to get to 
>the detail here, but as Yurong has pointed out, you need to figure out 
>how to get to the handle of the rebar control. 
> 

>In short, the easy way out is to implement the toolbar only for IE5. 
> 

>Hanyu Xiao 
> 

From: Yurong Lin (ylin@d ia Lpipex.co m ) Message 8 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.programming.webbrowser ctl 

Date : 1 999/1 0/0 1 View this article only 

Thanks Andrew. But, unless I am missing something, the URLs you mentioned do 
not seem to be relevant to the creation of tool band, they are about adding 
shortcut icons to favorite URLs or URLs in address bar. I am looking for the 
way to attach a tool band (or toolbar) to IE5, like the Yahoo Companion. 

Thanks 
Yurong Lin 

Andrew Nosenko wrote in message <#At9V5AD$GA. 296@cppssbbsa04> . . . 
>Different ways to do this: 

> http: //msdn. micro soft . com/w or kshop /A u thor /dhtml/howt o/Short cut Icon . asp 
>http_: / / s upport . mi crosof t . c om / s upp o r t / kb / a r t icles / Q 18 2 7 0 [/ 3 ± ^ AS P 
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> http: / /techn et .micr osoft . com/cdonline/Content /Complete/In t ernet /Client/IE/t echnote 

>/tipsauth. htm 

> 

>-- 

> Regards, 
>Andrew Nosenko, 
- >Senior Software Engineer 
>Mead & Company 
> 

>Custom look & feel for browser windows: 
> http: //www . m eadroid . com/wpm/ 

>MeadCo HTML printing article and samples on the MSDN: 

> http: //msdn .mi crosoft . com/workshop/author/script /dhtmlprint . as p 

>Advanced HTML printing: 

>ht tp : / /www . me ad r o i d . c pm/sj:r ij)t x / 

> 

>"Yurong Lin" <yurongl@context . co . uk> wrote in message 
> news : 37f 49d 8 e . 35934 07@msnews .microsoft . com . . . 
>Thanks, Hanyu. 
> 

»In fact a custom toolbar in IE5 does NOT require a BHO. It is only a 
»reg setting that you need to specify. The rest is pretty much like 
»implementing an explorer, bar. Search the MSDN for details. 
> 

>I have searched MSDN inside out but just can't find it. Any clue such 

>as its title, keywords or URL? 

> 

>Yurong Lin 

> 

> 

> 

>On Thu, 30 Sep 1999 18:56:45 -0700, "Hanyu Xiao" 

><gghxiao@nospam. hotmail . com> wrote : 

> 

Read the rest of this message,,. (34 more lines) 

From: Anthony ^ Qitrano (acitrano@maine.rr.com) Message 9 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE . .. . 

Newsgroups; microsoft.public.inetsdk.programming.webbrowser ctl 

Date: 1999/10/04 View this article only 

These URL's are great if you want to quickly add yourself as a favorite, but 
none of them address how to add a custom companion program like Yahoo! 
Companion to IE. Very, very different tasks. 

Anyone else?? 

/aac 

Anthony Citrano 

founder and president, BrainPaste.com, Inc. 

VP, Camden Technology Conference (must attend - http : / /www ^ ) 
Enough about me at http UJ^yi^..*.9k%I a . n 9. • c qm / T e ^ am / An . t ^h p n.y./ a n t hp n v__._h t m 



Andrew Nosenko <captain@meadroid. com> wrote in message 
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n ews : #At9V5AD$GA. 296@cppssbbsa04 . . . 

> Different ways to do this: 

> http : / /m sdn .mi cros o ft . com/ workshop/ Author /dhtml /howto/Short cut Icon . asp 

> h.t tjp : // s upp_q r t..._m i crqsqf t . com 2/0/34 . ASP 

http: //tech n et .microsoft . com/cdonline /Content /Complete/Internet /Client/ IE/ te 
chnote 

> /tipsauth . htm 
> 

> -- 

> Regards, 

> Andrew Nosenko, 

> Senior Software Engineer 

> Mead & Company 

From: Hanyu Xiao ( gghxiao@nosDam.hotmail.com ) Message 10 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.proaramming.webbrowser_ctl 

Date: 1 999/1 0/01 View this article only 

See http: //msdn. microsoft . com/workshop/browser /ext /overview/bands . asp 
Hanyu Xiao 

Yurong Lin <yurongl@context . co.uk> wrote: 

> Thanks, " Hanyu . 

> 

> >In fact a custom toolbar in IE5 does NOT require a BHD. It is only a 

> >reg setting that you need to specify. The rest is pretty much like 

> > implementing an explorer bar. Search the MSDN for details. 
> 

> I have searched MSDN inside out but just can't find it. Any clue such 

> as its title, keywords or URL? 
> 

> Yurong Lin 



Next 4 

Jump to [ End of thread ] 
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All messages from thread 

From: Borland ( i naj<s h i n @sp ry n e com ) Message 1 in thread 

Subject: IE4 Band Objects 
Newsgroups: borjandpuM 

borland.public.delphi.oleautomation, borland.public.deiphi.winapi View this article only 

Date: 1998/03/22 

If anyone is interested in testing D3 implementation of IE4 Band Objects, 
let me know. 

From: Thaddy de Koning ( thaddy@cyco.nl ) 
Subject: Re: IE4 Band Objects 

Newsgroups: borland.public.delphi.activex.controls.writing . 
borland.public.delphi.oleautomation . borland.public.deiphi.winap i 
Date: 1998/03/23 

I am. . . 
Thaddy 

Borland wrote in message <6f 3 j 4 0$aul8@f orums .borland. com>. . . 
>If anyone is interested in testing D3 implementation of IE4 Band Objects, 
>let me know. 
> 
> 

From: Jeff Rafter (jeffrafter@earthlink.net ) 
Subject: Re: IE4 Band Objects 

Newsgroups: borland. public.delphi.activex.controls.writinq , 
borland. public.delphi.oleautomation. borland. public.dejphj.winapi 
Date: 1998/03/23 

Interested, 

Jeff Rafter, Realsoft Development 
h 1 1 p : / ./ ww w_. re a ,1s of t de com 

From: Raymond Naseef (maseef@rdj^ 
Subject: Re: IE4 Band Objects 

Newsgroups: borland. public.delphLactivex.controls.writing, 
borland. public.deljDhi.ojeautomation, borland.public.deiphi.winapi 
Date: 1998/03/23 

Would you mind changing you display name? 
Borland wrote: 

> If anyone is interested in testing D3 implementation of IE4 Band Objects, 

> let me know. 



Message 2 in thread 
View Ms a 



Message 3 in thread 
View this a rticle only 



Message 4 in thread 
View this article only 



From: GP, Can/a I ho (gen i Q@j^ics .com ) Message 5 in thread 

Subject: Re: IE4 Band Objects 
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Newsgroups: borland.public.delphi.activex.controls.writina . 

boriand.^ borland_.jDublic.delphi.winapi View this article 

Date: 1998/03/25 



ADD-ME TOO 
G.P.Carvalho - JAPAN 

Borland escreveu na mensagem <6f 3j 40$aul8@ forums .borland. com> . 

>If anyone is interested in testing D3 implementation of IE4 Band . Objects, 

>let me know. 

> 

> 



From: Arien Wiersma ( wierfin(5>tref.nn Message 6 in thread 

Subject: Re: IE4 Band Objects 

Newsgroups: borland.public.delphi.activex.controls.writing . 

borland.public.delphLoleautomation . borland. public.delphLwinapi View this article only 

Date: 1998/03/26 " " " 



add me to the list too : ) 



Borland wrote in message <6f3j 40$aul8@f orums .borland. com>. . . 

>If anyone is interested in testing D3 implementation of IE4 Band Objects, 

>let me know. 

> 

> 



From: Marian Maier ( Maier@home.ivm.de ) Message 7 in thread 

Subject: Re: IE4 Band Objects 

Newsgroups: borland. public.delphi.activex.controls.writing f 

borland. public.delphi.oleautomation . borland.public.delphi.winapi View t his article only 

Date: 1998/03/27 

Hi, 

>If anyone is interested in testing D3 implementation of IE4 Band Objects, 
What are IE4 Band Objects? 
Ciao, MM 

Fon: +49 228 624013 Fax: +49 228 624031 
"Was schiefgehen kann, geht auch schief." 

From: Rudy Velthuis (rvelthuis@cww.de) 
Subject: Re: IE4 Band Objects 

Newsgroups: b orland.p ublic.delphi.activex.controls.writing, 
borland. public.delphi.oleautomation . borland.public.del p hi.winapi 
Date: 1998/04/02 



Message 8 in thread 
View this article only 



Marian Maier schrieb in Nachricht <351b83da . 7076258@news . ivm.de> . . . 
>Hi, 
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>>If anyone is interested in testing D3 implementation of IE4 Band Objects, 
> 

>What are IE4 Band Objects? 

Microsoft Internet Explorer 4.0 allows an application to define and 
create bands that are displayed within the shell and the browser. 

Internet Explorer 4.0 currently supports three different types of band 
objects: Desk Bands, Explorer Bands, and Communication Bands. Each 
type of band serves a different purpose. The following sections 
describe these different band types and their capabilities. 

Desk Bands are band objects that are displayed as a band in the shell 
taskbar or as a floating tool window on the desktop. Desk Bands are 
used to display information and to receive input from the user. They 
are available to the user throughout the entire Microsoft Windows 
session. Desk Bands are supported in shell versions 4.71 and later. 

Explorer Bands are band objects that are displayed in a browser 
window. They usually contain information or. supply tools that are 
helpful to the user while using the browser. These bands are displayed 
to the left of the current view and normally receive user input that 
results in some action being performed. Explorer Bands are supported 
in browser versions 4.71 and later. 

Communication Bands are band objects that are displayed in a browser 
window. This can be a Windows Explorer window or an Internet Explorer 
4.0 browser window. Communication Bands are normally used to relay 
information to the user. These bands are displayed below the current 
view and don't usually accept user input. Communication Bands are 
supported in browser versions 4.71 and later. 
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Messages 11-14 from thread 
Prey 10 

Jump to [ Start of thread ] 

From: Yurong Lin (ylin @dial.pipex.com ) Message 1 1 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.programming.webbrowser ctl 

Date: 1 999/1 0/01 View this article only 

If fact I have read over that article a number of times, it does talks about 
a lot about other band objects such as explorer bar, but nothing about tool 
band apart from the text below: 

"A tool band is a band object that was introduced with Internet Explorer 5 
to support the Microsoft® Windows® radio toolbar feature. This feature 
provides a way to put a window on a band contained by the rebar control 
that holds Internet Explorer's toolbars" 

"Users display the radio toolbar by selecting it from the Toolbars submenu 
of the View menu or from the context menu that is displayed by 
right-clicking the toolbar area." 

There isn't even a CAT ID for the tool band. 

Am I missing something? 

Yurong Lin 



Hanyu Xiao wrote in message ... 

>See http: //msdn . microsoft . com / workshop/browser/ext/overview/bands . asp 

> 

>Hanyu Xiao 

> 

>Yurong Lin <yurongl@context . co. uk> wrote: 
» Thanks, Hanyu. 

> > 

>> >In fact a custom toolbar in IE5 does NOT require a BHO . It is only a 
>> >reg setting that you need to specify. The rest is pretty much like 
>> implementing an explorer bar. Search the MSDN for details. 

>> 

>> I have searched MSDN inside out but just can't find it. Any clue such 
» as its title, keywords or URL? 

> > 

>"> Yurong Lin 

> 

> 

From: Hanyu Xiao (g ghxiao@nospam.hotmail.com ) Message 12 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk . prog ram min g.webbrowser ctl 

Date: 1 999/1 0/01 View this article only 

To rephrase what I said in my first post to this thread, a tool band 
is essentially an explorer bar plus a reg setting. You'd implement the 
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tool band as if it was an explorer bar. Then you put in the reg 
setting as specified in that MS article, and the explorer bar of yours 
will automatically show up as a toolbar. You may need to remove the 
CAT ID for this tool band so that it doesn't show up as an explorer bar 
at the same time. 

Hanyu Xiao 

From: raposa@iharv est.c om (rapos a @ih a rvest .c om) Message 13 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
N ewsg rou ps : micre^ft 

Date: 1 999/1 0/05 View this article only 

Adding a tool band a la Yahoo companion is definitely not easy. I've 
managed- to add a toolbar button to IE4 by using a browser helper object 
and then "hacking" into the rebar control (getting a handle to it is 
actually fairly easy - just run Spy++ and check out the window 
heirarchy and then enumerate through the windows matching on the class 
until you find the right one) . If you download iHarvest One 
( www ... ^arvestj. com ) and use it with IE4, you'll see this button. For 
IE5, it ? s easier to use the registry. 

Adding a band, however, is harder because IE does all kinds of tricks 
with maintaining the state of the rebar. I f m not even going to attempt 
it for IE4. Adding the band with IE5 is fairly straightfoward if you 
follow the instructions on their MSDN article. 

However, I did run into one problem - my tool band is named "Radio" in 
the context menu. (So I actually have 2 instances of Radio now in the 
menu) . The name shows up fine in the band, but I must be missing 
something. I've got the name in the registry and in the code. Has 
anyone run into this? 

Thanks 
-Scott 



Sent via Deja.com h t . t p ^ / / www \ dej a.£oni/ 
Before you buy. 

From: Parron l Devljn (MarshalLaw@worldnet.att.net) Message 14 in thread 

Subject: Re: How to add toolbar like Yahoo companion in IE 
Newsgroups: microsoft.public.inetsdk.programming.webbrowser ctl 

Date: 1 999/1 0/07 View, ihis2tfje!g_Qn|y 

> 

> However, I did run into one problem - my tool band is named "Radio" in 

> the context menu. (So I actually have 2 instances of Radio now in the 

> menu) . The name shows up fine in the band, but I must be missing 

> something. I've got the name in the registry and in the code. Has 

> anyone run into this? 
> 

Its a known bug. There is a KB article describing it. I don't remember 
the KB number off hand, try searching for "Tool band" or "Radio" and 
you should get it. 
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All messages from thread 

From: Zachary: Turner (zturner@bindvieyy,cgm Message 1 in thread 

Subject: Plugins for IE 
Newsgroups: mlcrpsoft^ 

microsoftpu^ View this ar ticle only 

micromf^ — 
Date: 2000-09-30 1 3:36:00 PST 

Does anyone know how I can develop a plugin for Internet Explorer? Any 
links to MSDN topics would be grateful. 

Thanks, 

Zachary Turner 

From: Dan MohrVMSV) ( danmohr-nospam@microsoft.com ) Message 2 in thread 

Subject: Re: Plugins for IE 

Newsgroups: microsoft.public.inetexplorer.ie4.activex_contrl . 

mlcro_sM^ View this article only 

Date: 2000-10-05 15:12:27 PST 

Developing a plugin for IE is bsically just like developing a plugin for 
Netscape. The main caveat is that IE has limited support for Netscape's 
Plgun API : 

http: //support .microsoft . com/support/kb/articles/ql66/6/94 . asp 
To get started, download the Netscape Plugin SDK for Windows: 

* L i ndex . html 

There's a sample called WinTemplate that is basically a skeleton plugin 
project for Visual C++. It's a great starting point. 

Hope this helps, 



Dan Mohr 

Microsoft Developer Support 
Internet Client Development 

"Zachary Turner" <zturner0bindview. com> wrote in message 
ne ws :GErB5. 34 257$3y3. 590918 gtyphoon. austin. rr.com . . . 

> Does anyone know how I can develop a plugin for Internet Explorer? Any 

> links to MSDN topics would be grateful. 
> 

> Thanks, 

> Zachary Turner 
> 

> 



©2004 Google 
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All messages from thread 

From : Lionel Schieper (Lionel . Sch iepers@advalvas. be) 
Subject: Toolbar like IE4 
Newsgroups: mjcrpsoft.public. vc.mfc 
Date: 1 998/04/23 



Message 1 in thread 



View this article only 



With the technology preview for VisualC++ 5, is there any way to have 
toolbar like IE4 and not rebar like IE3. 
Does someone have example? 

I have tried some code from www . codeguru . com but all i have is rebar. 
use CToolBar class) 

Lionel Schiepers ( Lionel.Schiepers@advalvas.be ) 
Student at HEPL Rennequin Sualem in computer science 
In.Pr.E.S Seraing (belgium) 



(it 



From: Sergio Lopes ( sergio.lopes@mail.telepac.pt ) 
Subject: Re: Toolbar like IE4 
Newsgroups: microsoft. public. vc.mfc 
Date: 1998/04/23 



On Thu, 23 Apr 1998 13:52:28 +0100, "Lionel Schieper" 
<Lionel . Schiepers@advalvas . be> wrote : 



Message 2 in thread 



Vi ew this article only 



>With the technology preview for VisualC++ 5, is there any way to have 
>toolbar like IE4 and not rebar like IE3. 
>Does someone have example? 

>I have tried some code from www . codeguru . com but all i have is rebar. (it 
>use CToolBar class ) 

The technology preview installs a sample of an IE4 style 
minibrowser . . . check it out at : 

\ Program Fi les\DevStudio\preview\vc\ samples \mfcie 

bye, 
Sergio Lopes 
MCSD 

sergio . lopes@mail . telepac.pt 



From: Charles Steinhardt ( Csteinhardt@omg-inc.COM ) 
Subject: Re: Toolbar like IE4 
Newsgroups: microsoft. public. vc.mfc 
Date: 1998/04/23 



Message 3 in thread 



View this article only 



Take a look at the MSDN under: 



The Rebar Control: Using a Coolbar in Your Application 
Nancy Winnick Gluts 
Developer Technology Engineer 
Microsoft Corporation 

October 1996 

Updated June 24, 1997 
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Contents 

What Is a Coolbar? 
Creating a Coolbar 
Messages and Notifications 
Summary 

Abstract 

One of the controls created for Internet Explorer 3.0 is the Rebar 
control. It is most commonly known, however, as the coolbar. A coolbar 
contains child windows such as toolbars, combo boxes, and bitmaps, and 
manages the size and position of the child windows it contains.- Once 
you create the child windows and assign them to the coolbar, the child 
windows are displayed in it. This article demonstrates how to create 
and use a coolbar. The sample that accompanies this article, 
creatively named "Rebar, " was written using Microsoft® Visual C++® 
version 4.2, the Win32® Software Development Kit (SDK), and the 
ActiveX™ SDK for Internet Explorer 3.x. If you are going to use the 
coolbar in an application targeted to Internet Explorer 4.0, use the 
Internet Client SDK (INet SDK) instead of the ActiveX SDK. 

Charles Steinhardt [MVP] 



Lionel Schieper wrote in message . . . 

>With the technology preview for VisualC++ 5, is there any way to have 
>toolbar like IE4 and not rebar like IE3. 

The IE3 and IE4 Toolbars are the same. Both are ReBarWindow32-Controls . Only 
the gripper has been changed! 



Need a web-solution? 
Visit the WebFX-site! 



Daniel Weber 
sysdev@gmx . net 



From: Daniel Weber (s vsdev(5)amx.net ) 
Subject: Re: Toolbar like IE4 
Newsgroups: microsoft.public.vc.mfc 



Message 4 in thread 



Date: 1998/04/23 
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Messages 1-10 from thread 

From: James Tinkess (j ame st@s ym patico.ca) Message 1 in thread 

Subject: Whats the deal with Yahoo Companion? Standard plugin API or not? 
N e wsg ro u ps : netscape. de vs-plugins 

Date: 2000/01/12 View this article only 

Whats the general consensus on YCompanion. Its tight integration with 
the browser and the fact that no other portal offers one quite like it 
leads to believe that there is more going on? 

Can anyone enlighten me on this, I would like to create a custom toolbar 
as well 



regards, 
James 



From: Daniel Vernon ( dvernon@emediat.com ) Message 2 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/01/1 3 Vieyy this article only 

Man... 11/3/99, there was posting by someone who claimed to know how 
companion worked. He even offered to explain it to me if I was interested, 
but I never replied. If you had come here 10 days ago you would have seen 
the posting. Anyway, I will search my inbox and see if the newsgroup sent me 
a copy of his reply. 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 



From: James Tinkess (jamest@sympatico.ca ) Message 3 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/01/1 3 Vjewjhis article only 

Any pointers would be greatly appreciated. I have really scoured the search 
engines and have gotten very little info. 

thanks, 
james 



Daniel Vernon wrote: 

> Man. . . 11/3/99, there was posting by someone who claimed to know how 

> companion worked. He even offered to explain it to me if I was interested, 
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> but I never replied. If you had come here 10 days ago you would have seen 

> the posting. Anyway, I will search my inbox and see if the newsgroup sent me 

> a copy of his reply. 

> 

> James Tinkess wrote: 
> 

> > Whats the general consensus on YCompanion. Its tight integration with 

> > the browser and the fact that no other portal offers one quite like it 

> > leads to believe that there is more going on? 

> > 

> > Can anyone enlighten me on this, I would like to create a custom toolbar 

> > as well 

> > 

> > regards, 

> > James 

From: Sundar Jayabose (sjayabose@ag enc y.com) Message 4 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscjape^ 

Date: 2000/01/1 3 View this article only 

Same here. I'd like to hear anyone's thoughts on how that Yahoo Companion is 
done ! 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? . 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

From: Vauqhan Knight ( vaughan@reason.com.au ) Message 5 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: nj^^ai^deysrplugins 

Date: 2000/01/18 View this article only 

ok, 

it's a deal with netscape. there's a fair bit of i'll scratch your back, 
you scratch mine going on. 

firstly, YC is a plugin that associates itself with the netscape default 
mime-type. so that's EVERY mime type. therefore, you load up a html page, 
a *.swf page, a *.avi file, and it loads. it doesn't touch the files, and 
if need be, the appropriate plugin for that file loads and takes care of it. 

this way, it appears to be perminently there. how it gets itself onto the 
toolbar is where yahoo and netscape start exchanging funds, rumour is that 
yahoo got some inside development info for a price. 

so, your can either be very lucky, or you can pay netscape the funds to have 
them supply the code . 
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i 1 ve given up on toolbars, it's all up hill. 
Vaughan 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration. with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? 

> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 
> 

> regards, 

> James 

From: James Tinkess (jamest@sympatico.ca ) Message 6 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape, devs-plugins 

Date: 2000/01 718 View this article only 

Thanks for the info, doesnt look like its going to be an "off the shelf" job:-( 
Vaughan Knight wrote: 

> ok, 

> 

> it's a deal with netscape. there's a fair bit of i'll scratch your back, 

> you scratch mine going on. 
> 

> firstly, YC is a plugin that associates itself with the netscape default 

> mime-type. so that's EVERY mime type, therefore, you load up a html page, 

> a * . swf page, a * . avi file, and it loads. it doesn't touch the files, and 

> if need be, the appropriate plugin for that file loads and takes care of it. 

> 

> this way, it appears to be perminently there, how it gets itself onto the 

> toolbar is where yahoo and netscape start exchanging funds. rumour is that 

> yahoo got some inside development info for a price.- 
> 

> so, your can either be very lucky, or you can pay netscape the funds to have 

> them supply the code. 

> 

> i've given up on toolbars, it's all up hill. 

> 

> Vaughan 
> 

> James Tinkess wrote: 

> 

> > Whats the general consensus on YCompanion. Its tight integration with 

> > the browser and the fact that no other portal offers one quite like it 

> > leads to believe that there is more going on? 

> > 

> > Can anyone enlighten me on this, I would like to create a custom toolbar 

> > as we 1 1 

> > 

> > recrards, 

> > James 
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From: Marc Hansen (m hansen@engr.sgi.com ) Message 7 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: nMscap^ 

Date: 2000/02/08 View this article only 

check out h ttp: //www. jesof t . com/ 

They've created a plugin ( jc_activedoc) that embeds a document from an 
active document server full page in netscape. The toolbar (s) from the 
server show up too. Unfortunately, they don't do menu merging. 

So it seems like it's possible. 

here's a posting from netscape . plugins that also mentions toolbars 
(the subject was "Plugin-in Menus") : 

Eric wrote in message <389CD64B . DDED820B@noonetime . com>. . . 
>Hi, 

>I would like to create a plugin with a menu, does anybody know where 
>there is good documentation on this or can anybody give me some example 
>code? Anything would be greatly appreciated. I have gone through 
>Netscapes documentation and have not been able to find what I am looking 
>for . 
> 

>Thanks in advance, I would greatly appreciate anything that would be 

>helpful. 

>Eric 

> 

You can use normal menus as well as the popup ones in your plugin both have 
a simple solution. 

If you are in Windows, then First you subclass the Netscape window (client) 
with your own window 

which will have the menu. Specify it in the WNDCLASS structure, and register 
the Window, for the 

popup menus you can respond to WM_CONTEXTMENU message with TrackPopupMenuEx . 
If you are using MFC then Subclass the Window using CFrameWnd with parent 
window as the subclassed window 

With this window you can put Menus as wel as toolbar etc in your plugin 

Best of Luck 
Bhushan 

James Tinkess wrote: 

> 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? 

> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well 

> 

> regards, 

> James 



-larc Hansen 1 Silicon Graphics | MineSet Data Mining. & Visualization 
i::h a ns e n@ eng r . sq i . com I 6 5 0 . 9 3 3 . 4 & 0 6 1 h t tp_:_ / / www . mineset . sqi . co m 
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From: Alex Cohn ( alexcohn@netvision.net.il ) Message 8 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/02/09 View th is a rticle only 

It's no big deal to show toolbars in the plugion window. The trick of Yahoo 
Comanion is that it seems to be a plugin that gets loaded when Netscape is 
launched (no matter what URL it points to) and stays active no matter where the 
user surfs. And its additional toolbar is just one of the Netscape toolbars, 
with the same look-and-f eel . 

Alex 

Marc Hansen wrote: 

> check out http: / /www . j csof t . com/ 

> They've created a plugin ( jc_activedoc) that embeds a document from an. 

> active document server full page in netscape. The toolbar (s) from the 

> server show up too. Unfortunately, they don't do menu merging. 

> 

> So it seems like it's possible. 

From: DJ Vernon (dvernon@emedi at.co m) Message 9 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
Newsgroups: netscape.devs-plugins 

Date: 2000/02/23 \fi^.thisarti£lS.Q^ 

James Tinkess wrote: 

> Whats the general consensus on YCompanion. Its tight integration with 

> the browser and the fact that no other portal offers one quite like it 

> leads to believe that there is more going on? 
> 

> Can anyone enlighten me on this, I would like to create a custom toolbar 

> as well. 
> 

> regards, 

> James 

I was thinking about this and then a possibility came to mind. As it turns 
out, any process can write display info to any window handle if you know 
the window id. For example, the plugin I designed basically spawns a 
seperate app and passes the window handle to the app as a command line 
parameter. Then I am able to draw to the canvas inside netscape from a 
seperate process. When I do this and the plugin is destroyed, the process 
will keep running (unless I tell it to close in the plugin destructor. . . 
which I do) . 

So, with this in mind, I was thinking about the Unix command XTree... (or 
something like that) . XTree allows you to search for a windows siblings and 
parent. As it turns out, a plugin canvas in Linux is about the 11th 
ancestor of the root window. In theory, if you back traced enough, you 
could get the window handle of the netscape HTML display canvas... and the 
HTML display canvases immediat parent. What would stop you from resizing 
the display window? Or even adding a new window to the displaced area? Mind 
you, this is all theoretical. But, I could resize netscapes window to make 
roo for my "ToolBar" . . . create a new child window in the toolbar area and 



* 
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pass that to a seperate process. Then, even if the plugin gets destroyed, 
the seperate process keeps running and displaying to the window I created. 

If the seperate application was DDE enabled, this might explain how it 
tells netscape to go to urls when you press on certain buttons. 

Just a thought . 

From: John Ma Gmarti^ Message 10 in thread 

Subject: Re: Whats the deal with Yahoo Companion? Standard plugin API or not? 
N ewsg ro u ps : netscape ins 

Date: 2000/02/27 View th is article only 

> So, with this in mind, I was thinking about the Unix command 

> XTree... (or something like that). XTree allows you to search 

> for a windows siblings and parent. As it turns out, a plugin 

> canvas in Linux is about the 11th ancestor of the root 

> window. In theory, if you back traced enough, you could get 

> the window handle of the netscape HTML display canvas... and 

> the HTML display canvases immediat parent. What would stop 

> you from resizing the display window? Or even adding a new 

> window to the displaced area? Mind you, this is all 

> theoretical. But, I could resize netscapes window to make roo 

> for my "ToolBar"... create a new child window in the toolbar 

> area and pass that to a seperate process. Then, even if the 

> plugin gets destroyed, the seperate process keeps running and 

> displaying to the window I created. 
> 

> If the seperate application was DDE enabled, this might explain how it 

> tells netscape to go to urls when you press on certain buttons. 

That's absolutely correct. Under Windows you can 1 hijack' pretty 
much any window and write to it. You can also intercept messages 
to react to events. But because of the insertion of a registry 
key under a Netscape's registry area, I doubt this is what 
they're doing. 

The other piece of software that Vaughan was referring to was 
ThirdVoice ( www. thirdvoice . com ) . They have jusc released a 
Netscape version of their software. They do a similar thing to 
Yahoo, but they start painting in the actual rendering area. 
Now, I can't be 100% sure, but I think they're using the Yahoo 
hack. I *think* I saw something about 'Loading Yahoo in the 

splash screen when Netscape starts up. Has anybody else noticed 
this? 

John . 
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